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TO THE STUDENT 



I developed this eBook specifically for students who are preparing for their first computer programming language 
class. The material for this eBook was created from a programming teacher's perspective. I have spent several 
years preparing students for careers in programming. This includes spending many classes explaining sometimes 
complex topics like object orientated programming. My time in the classroom has prepared me to identify topics 
that need special consideration or perhaps a special approach. I know where students have had problems and I 
have tried to anticipate those areas in this eBook. I use the benefit of my experience to present descriptions and 
analogies that I know have worked in the past. The topics, examples and case studies used are constructed 
specifically to make the material very approachable and straightforward. 

If you are using this eBook and you've already taken a programming language class, then I suspect you're looking 
for the opportunity to revisit some of the logic design needed to create successful computer applications. 

For example, you might like to review structured programming one more time to get a better understanding of 
nested if statements or modularizing program logic. You might also be using this eBook to help you attain a better 
understanding of object oriented programming (always a complicated topic). 

Whether you're using this eBook prior to taking your first programming class or using this textbook as part of a 
programming logic course, you'll find that the topics are presented in an easy to understand fashion with special 
emphasis on understanding the fundamental concepts necessary to develop quality software programs. You will 
also find many topics presented from a programmer's perspective. It is critical that as a new programmer you are 
given exposure to what is important and necessary to be a professional programmer. 



The cover page of each chapter will provide a summary of learning objectives. These learning objectives will be 
represented as bullets and each bullet will relate to a topic covered in the chapter. Each chapter will contain an 
explanation about why the material is important to your understanding of the objectives and also why it is 
important to know as a programmer. Many times I will discuss "WHY" something is important in terms of an 
occupational setting. I might use a story based on my experience as to "WHY" a topic is important to becoming a 
successful programmer. This will put the concepts covered in a context that will help you understand "WHY" we 
are learning this material. Knowing "WHY" a concept or topic is important will help to give it credibility and 
relevance. Understanding the background of the concept will help assign it priority and help you understand how 
different topics relate to one another. You will have a better understanding of the "bigger picture" of how 
programming logic fits into computer programming. 

Next, I will present the main learning items or concepts for the chapter. Concepts will be addressed as if you had 
never been exposed to them before. Since all students learn differently, I will present these concepts as text, as 
diagrams, and pseudo code. Mixed in with concepts will be sidebars that identify Related Subjects and Background 
Information. A "Tip" or "Sidebar" might be a question asking you to think about a particular scenario related to the 
topic or it might be a point worth repeating because of its importance or complexity. I have included short topics 
called "Key Concepts", "Logic Tips" and "Programming Tips" to focus on specific points that will help expand and 
clarify important larger concepts or topics. Also included in each chapter are "status checks" to make sure that you 
understand key concepts before moving on to new topics. 




LAYOUT OF EBOOK MATERIAL 
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In each chapter, I will have a short section dealing with a real life case study and its programming solution. You will 
use concepts discussed in the chapter to solve this problem. I will use this same company (Cactus Books and Tapes) 
in each chapter but will modify the case study to reflect on the main points of that chapter. 

In the "Putting it to Use" section, I include topics for those interested in a career in programming. "Putting it to 
Use" will contain topics called Best Practices which give you real world concepts important to your success as a 
programmer. 



TO THE INSTRUCTOR 

This eBook was developed to supplement material on programming fundamentals typically covered in lecture. The 
eBook was designed to define programming from an occupational standpoint. The programming examples were 
developed as business examples which would be typically found in a Computer Information Systems programming 
course. 

The target audience for this book is students who have participated in some type of entry level computer training. 
No prior programming is considered necessary to use this eBook but knowledge of executing programs along with 
routine file maintenance operations is expected (copy, cut, paste, etc.). 

Even though the eBook uses pseudo code to demonstrate program development, the eBook could very easily be 
used to provide introductory instruction for just about any programming language available today. 

The approach used to train the new programmer follows common programming processes that stress the 
development of logic models first, the coding of program second and finally program test. This structured 
approach is used to demonstrate that program development is a repeatable process that can be performed using 
the same development steps over and over. In this textbook, programming is defined as a discipline that like any 
profession follows industry standards. 

The eBook was developed to introduce the new programmer to structured programming first. Building on those 
structured programming topics, it then moves into program development of object orientated programs and 
finishes with a discussion of event driven programming. 

Below I have summarized the pedagogical elements used in defining concepts in this eBook. 

Sidebars - Short stories or topics on occupational aspects of programming 
In Practice 

Background Information 
Related Subjects 



Tips - Paragraphs on important technical items 

• Programming Tips - Programming related 

• Logic Tips - Logic related 

• Key Concepts - Process related 



Best Practices 
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1. Programming Practices 



Assessment 

1. Status Check 



Terms / Code 

• Floating Glossary 

• Word term highlighting 



Other 

• In Chapter Case Study 

• Color graphics 
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CHAPTER 1 UNDERSTANDING PROGRAM LOGIC AND PROGRAMMING 



In this chapter, you will learn how to: 

2. Define program logic and connputer program. 

3. Describe tlie relationship between computer programming logic and computer programs. 

4. Explain the process of solving a problem with program logic and a computer program. 

5. Describe why program logic is modeled with pseudo code and flow charts before being transformed into a 
program. 

6. Recognize the importance of program development methodologies like the program development 
process and the system development life cycle to develop computer 

7. Describe the roles and responsibilities of programmers and the processes programmers use to create 
programs. 

8. Differentiate between compilers, interpreters and virtual run-time machines in regards to building and 
executing programs. 



WELCOME TO COMPUTER PROGRAMMING 

I would like to officially welcome you to computer programming. I am excited that you have selected this eBook to 
learn how to develop your own computer programs. I will give you all the information and examples necessary to 
understand the basics of computer programming. I will use standardized programming techniques and tools which 
have long been used by programmers to create quality computer applications. I will incorporate common sense 
explanations with a variety of examples to make sure the theory is backed up with application of that theory. 

Programming logic is the central focus in this eBook along with how they are used by programmers to write 
efficient and effective computer programs. Every program should start with program logic, which is the blueprint, 
and end with the coding of programming language statements. The initial chapters of the eBook will be dedicated 
to logic structures and specifically, structured programming. In later chapters, we will tackle more challenging 
programming techniques like object orientated and event driven programming. 



As a programmer who has been writing programs for more than twenty years, I have always enjoyed the challenge 
of programming and I hope that my passion for programming will rub off on you also. For me, the next best thing 
to writing my own programs is helping a new programmer learn how to write their own programs. There is nothing 
more rewarding then to see the pride of accomplishment in a student's face when they create their first computer 
program. Let's get started 
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Computer Programming - Computer programming is an activity performed by a computer programmer. It always 
starts witli a person. It includes a process of creating logic models which is converted into program language 
instructions that are later executed on a computer. The goal of the program is to solve a problem or perform a 
task. Like a recipe provides instructions for a cook, a computer program provides instructions for the computer. 



Program Logic - Program logic is used by programmers to model the programming language instructions carried 
out by the computer when the program is executed. Think of program logic as instructions you might give 
someone on how to make something or perform a task they have never done before. Program logic structure 
instructions might provide a program decision (i.e. if file does not exist, display message) or a loop through a series 
of repeated instructions. You might also think of your logic model as a blue print where you have mapped out the 
instructions but have yet to put them in a program as program language statements. 



Programming Language Statements: Programming language statements (also called source code) are used to 
implement program logic by sending instructions to the operating system. 



Programming Tip: Logic models are programming language independent which means logic writing concepts in the 
eBook can be used across all programming languages. 



A COMPUTER PROGRAM 



LOGIC 


PROGRAM 


MODEL 


STATEMENTS 


STEPI 


STEP 2 



Figure 1: A Computer Program and its Parts 



A DISCIPLINED APPROACH TO PROGRAMMING 

When we learn about logic and programming, we will always examine WHY we are using that logic structure or 
programming methodology. Whenever a new topic is introduced we will stop to discuss WHY that topic best fits 
the situation we are trying to solve. We will follow this explanation with examples. The examples will include 
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pseudo code, flowcharts, UML (Unified IVlodeling Language), PYTHON programs, illustrations and case studies. In 
this eBook, we will use a variety of approaches and different learning styles to provide real life solutions to real 
business problems. We will apply concepts to case studies and assess our progress to get feedback on in 
understanding how and why the topics of that chapter are important to becoming successful programmers. 

There are many textbooks that teach you how to program. These textbooks cover the syntax and structure of how 
programs are constructed specific to a particular programming language. One of the more popular programming 
languages is Microsoft's Visual Basic. In the typical introductory Visual Basic class, the student learns Visual Basic 
statements and keywords, how to implement programming logic and structures and finally, how to use the Visual 
Basic development environment to build and test his program. This approach to learning programming stresses 
how to create Visual Basic programs but not effective programming logic design. There is a weakness in learning 
programming with this approach. The emphasis is not on WHY it needs to work a certain way but instead what it 
will look like. As you'll see in this eBook, the direction will in formulating efficient, flexible, reusable, high quality 
programs that follow accepted programming standards. 

Since the logic is used to design the solution, you must also understand that construction of logic are key to good 
programming. Let me illustrate with an example. I think most of us would admit you probably don't have to be an 
architect to design a house. After all, most of us have had some experience living in a house. Through this 
experience, we could design what you would find in your typical house (rooms, doors, windows, roof, etc.). I also 
think most of us would be able to assemble something that looked like a house if given the appropriate building 
supplies and tools. We could build a house that had at peaked roof, had some windows, had a front door and 
would have walls and ceilings that would make the house habitable. From a distance, the house might look like 
every other house on the street. However, would the house be structurally sound? Would the house meet the 
appropriate construction code regulations? If another plumber or electrician came to this house and had to make a 
repair, would they be able to? What this house we built meet the professional standards found in the work of 
professional builders, plumbers and electricians? I don't think so. We know how to build it but not why a floor 
needs certain supports or why wall studs hold up the ceiling. 

This same analogy holds true in first time programming classes. Many times because of time constraints and the 
amount of material that must be learned, entry level programming classes have to focus on the "HOW" and not 
the "WHY" of a programming language. "HOW" might get the assignment done and a compiled program but it 
does not necessarily make you a programmer. Once you know "WHY", you can use the "HOW" to implement the 
solution. Once we know the "WHY" of programming logic and how to use structured and object oriented 
fundamentals, we will be able to build programs that follow professional standards for design, and maintainability. 
Knowing "WHY" we do things is what makes the practitioner a professional. In our case, knowing "WHY" is 
important in becoming an effective programmer. 



THE PROCESS OF PROGRAMMING 

The goal of this eBook is to teach you about programming. Programming is a process and made up of several 
activities. The program process starts with the modeling of logic. This is also where we will focus much of our 
instruction. It is often is the neglected piece of the programming processes but critical for new programmers. Once 
the logic is complete programming starts. A completed program must finally be tested before put into production. 
This eBook was designed to provide instruction on programming for a variety of programming languages (language 
independent). The process of programming is the same no matter what programming language is used (i.e. Visual 
Basic. Net, C++, C# or Java). 



Key Concept: A program is the implementation of your program logic with programming language statements. 
Program logic and programming come together like a pilot and his airplane. Each by themselves offers little but 
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together, they can provide much more. In short, programming logic is your plan for solving a problem and the 
program is the implementation of our program logic with programming language statements. 



Program Language Statements - Program language statements are English like statements that when executed in 
the correct sequence can instruct the computer to perform a series of tasks. There are many computer 
programming languages each having differences and similarities. The differences allow some programming 
languages to work with some computer applications better than others (i.e. the COBOL computer language has 
long been a favorite of business programmers. 



A FIRST LOOK: UNDERSTANDING PROGRAMMING PROCESS 

We must start our understanding of programming by dispelling a few computer myths. Many of us have grown up 
with a "Hollywood view" of computers. That view has presented the computer as some sort of super brain. A 
device that we need only ask questions of and it will return to us knowledge we don't possess. A machine that can 
reason, learn or acquire intelligence on its own. 

This could not be any farther from the truth. One of the difficulties in learning how to implement programming 
logic is the constraints the computer places on us in solving business problems. The human brain is far more 
complex and the brain's ability to reason and learn far exceeds that of a computer. Computers are only as smart as 
the persons programming them and you must condition yourself into providing an instruction (logic) for everything 
a computer program needs to do. Planning or modeling program logic before we create programming statements 
is one way for the programmer to condition the solution into one the computer can perform. Without a logic 
model it is easy for the new programmer to assume the computer can perform more than it is able. We will learn 
more about logic structures in later chapters but first we will give you a first look. 

I often use the example of making a peanut butter sandwich to illustrate the intelligence (or lack of) of the 
computer. Making a peanut butter sandwich is a task that any three years old could handle. Let's see what we 
would have to tell the computer in the form of logic instructions to make a peanut butter sandwich. I will 
accomplish this by documenting the logic necessary with a programming modeling language called pseudo code to 
build the necessary instructions. 



Pseudo Code: Pseudo code is a nonstandard English-like programming language used by programmers to model 
logic and instructions. Pseudo code is called a programming language even through it cannot be excluded by a 
computer. It is designed for planning purposes only. By nonstandard, if you open five books on programming, all 
would have pseudo code examples but all of those examples would look somewhat different. Most computer 
languages have required standards that must be followed when creating programs. Pseudo code provides us with 
a way to concentrate on just logic structures without be constrained by the syntax rules of a particular 
programming language. 



In Practice: Pseudo code for Creating Programming Logic - Pseudo code has long been used as a mechanism for 
modeling logic before the logic is implemented as source code statements in a program. We will formally introduce 
pseudo code later in the eBook. We use pseudo code because it is an excellent way to just concentrate on 
programming logic without being constrained by the rules of a specific programming language. The beauty of 
pseudo code is that since it is a list of English instructions, you can easily document the process steps and validate 
the steps with others. Even persons with no formal understanding of programming logic or programming, can 
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participate in the creation of pseudo code. Pseudo code is not like a formal programming language and if you can 
read you can follow logic documented in pseudo code. I 

One of the difficulties in teaching logic with pseudo code has been its nonstandard nature and the fact that since it 
is not a true programming language, the logic statements cannot be executed on a computer. By not being able to 
execute the logic, it is not possible to validate the program logic to make sure that it was constructed correctly and 
arrives at the correct solution. 



Status Check: 



Why logic is modeled first rather than just writing the program from scratch? 
What does it mean when we say pseudo code is language independent? 
What do we mean when we say programming is a process? 

PSEUDO CODE FOR A PEANUT BUTTER SANDWICH 

Let's set up the logic instructions with the following scenario. You have at your disposal a kitchen robot. This 
kitchen robot is capable of taking instructions that will allow it to move around a kitchen, find various food 
ingredients, and mix and prepare those ingredients. Your pseudo code program needs to give the robot the 
instructions to create a peanut butter sandwich. 

• Task 1: Find a peanut butter in Kitchen Pantry 

o IVIove across the Kitchen to the Kitchen Pantry 

o Does Kitchen Pantry have a door? 

o If yes then, open door 

■ lf_count equals number of shelves are in the pantry 

■ While count is less then or equal to shelf_count and peanut_butter not found 

■ Search shelf 

■ If peanut_butter found then peanut_butter equals true 

■ Remove peanut_butter from selected shelf 

■ add one to count 

o If peanut_butter not found check refrigerator 

■ Move across the Kitchen to the refrigerator 

■ Open refrigerator door 
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shelf_count equals number of shelves are in the refrigerator 



■ While count is less then or equal to shelf_count and peanut_butter not found 

■ Search shelf 

■ If peanut_butter found then peanut_butter equals true 

■ Remove peanut_butter from selected shelf 

■ add one to count 

o If peanut_butter not found then Display "No peanut better today Msg." 

• New Task: Open jar 

o Turn peanut_butter lid counter-clockwise 

■ If peanut_butter jar equals empty then "No peanut better today Msg." 
o New task: Find Bread 

■ more instructions here 

• New task: Find butter knife to spread Peanut Butter nnore instructions liere 

I think you can see wliat is happening liere. What would be a very easy task for your typical three year old to 
accomplish becomes very difficult for the computer because of the amount of logic detail we must supply. It's not 
so much that programming logic is complicated but more because of the amount of detail we have to build into 
our instructions. Our brain is much more sophisticated and powerful and works much differently than a computer. 
Because of this, we have to break down even simple tasks to a much lower level so that the computer can process 
them successfully. 



Logic Tip: Most students will initially have a problem with program logic because they are not familiar to the very 
unnatural process of breaking down instructions to the computer at that low a level. We will be the chance to 
learn more about logic in later chapters. 



After seeing how complex a peanut butter sandwich becomes when documented as logic steps, was it the 
computer that caused the problem or was it the programmer of the computer application? What was needed was 
additional program logic in the payment processing program that would have softened the penalty if the under 
payment was less $10.00 dollars. Unfortunately, blaming the computer is very easy but also very incorrect (not to 
mention the additional cost associated with losing a previously loyal customer). Now I've let you in on that secret. 
The real brain behind the computer program is the person who programmed it. 



Related Subject: Blame it on the computer - "The computer did it!" Have any of you ever experienced this? An 
organization you do business with has made a mistake concerning your account (i.e. they forgot to credit a 
returned item to your monthly statement). Their response to the error is, "the computer did it. It is not our fault!" 

I can fondly remember one day receiving a rather threatening notice from a local department store because my 
payment had mistakenly been processed $2.00 short of the monthly invoice amount. Needless to say, I wasn't 
happy when they threatened to turn me into a credit agency for two dollars. I called the customer service 
department to communicate my dissatisfaction. The person on the other end of the phone, although apologetic, 
could only say that my problem was the result of the computer causing an error. No person there was certainly at 
fault. "You know these computers, they are always making errors." The computer was cause of my problems. The 
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computer was the one I should direct my displeasure to. I asked if I could talk to the computer. The phone went 
silent. 



PROGRAM LOGIC AND AN APPLICATION COMPUTER PROGRAM: 



In this eBook, you will see repeated references to program logic and application computer programs. We are 
focusing on program logic in this eBook but it is important that we also refer to programs since the two subjects 
are so closely tied to one another. We will do a more formal introduction on programming in the next section but 
look at the relationship between program logic and a computer program in the following diagram (see Figure 1). 
Note how programming languages also use English like statements to represent instructions to the computer. 
Computers do not speak English (although I talk to mine all of the time). 



(A) 


(B) 


Program Logic 


Computer Program 




(PYTHON) 


Read number from keyboard 








Store number in variable A 




A = input("enter a Number") 


Read number from keyboard 




B=input("enter a number" 


Store number in variable B 




Total = 0 


Create variable Total 




Total = A + B 


Calculate: Total equals A + B 




Print Total ^^^ammmmmmt 


Display Total 

i 









Figure 2: The graphic represents the relationship between program logic and a computer program. Pseudo code 
statements from Box A are converted by the program to program language statements (PYTHON) shown in Box B 

AN EXAMPLE: PROGRAM LOGIC TO ADD TO NUMBERS TOGETHER 

We will use four approaches to model program logic. The simplest approach is pseudo code. As we get deeper into 
the eBook and begin our learning on structured programming, we will introduce flow charting. Flowcharting is the 
most graphical of the three approaches we will cover and we will introduce flow charting in a later chapter. 

Flow Chart - a flow chart is a standardized technique for graphically representing graphics with a set of 
standardized symbols that represent program logic. To read the sequence of logic steps in this flow chart, just 
follow the letters. 
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Prompt for 
numb«r 



B 




Figure 3: Sample Flow Chart 



A COMPUTER PROGRAM DEFINED 



I can still remember the day when I was asked by the Leader of my daughters Girl Scout troop to come in on career 
day and describe to the other Girl Scouts what I did for a living. Maybe the truest test of understanding a subject 
matter is to take something that can be as complicated as programming and reduce it to an explanation that even 
the youngest of students can understand. 

For me, my simplest definition of a program is a series of instructions used to solve a problem with a computer. For 
the Scout troop and for the programming beginner, my explanation is it's like a recipe for chocolate chip cookies. 
For most of us, we start with a recipe. A chocolate chip cookie recipe provides a set of instructions that tell you 
what ingredients are needed, how each ingredient should be prepared and the sequence in which each ingredient 
needs to be combined to make the cookie dough. There are also instructions in the recipe on the temperature of 
the oven along with the time it takes for the cookie to cook. A recipe has everything you find in a computer 
program. 



30 
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Status Check 

Why is the computer program only as good as the programmer programming it? 

What are some of the advantages of using a programming language like PYTHON to help learn about program 
logic? 

Can you define and differentiate between program logic and programming? 



TYPES OF COMPUTER PROGRAMS 

Now would be a good time to introduce you to some different types of computer programs. Yes, not all computer 
programs are the same. Our example program (adding two numbers together) was a custom application program 
used for a specific business problem (adding two numbers together). This is not the only type of program. The 
Windows XP operating system program that came with our PC is also a computer program. It differs in both 
complexity and purpose but it is still a program. Even though these programs has a very different purpose, they 
were all built from a logic model and converted into computer programming language statements. 

IVlost computer programs fall under three classifications. These classifications are operating systems, packaged 
applications (also called shrink wrapped applications because they are sold in the store boxed in plastic) and 
custom applications which are written to solve a specific problem. The applications we will create and execute in 
this eBook are custom applications since they are created as business applications for individual use. 

Operating system software like Microsoft Windows or Linux are sophisticated programs which control the 
computers resources (hardware and connected devices) along with launching application programs (maybe like 
our PYTHON program we had seen earlier) or from an application program like Microsoft Word. The operating 
system is perhaps the most important applications program on our computer because without it, other programs 
could not be executed and the attached hardware is in accessible. 



Key Concepts: Operating systems allow for the execution of applications programs. 



Packaged software is application programs which are written to solve a particular type of generic problem. For 
example, a spreadsheet application is a program which is designed to provide a matrix of rows and columns where 
data and expressions can be inserted and manipulated. The program has a generic quality that allows it to be used 
for a number of different activities related to manipulating and modeling numbers. Spreadsheets are very popular 
with people who work with accounting tasks. Packaged software application programs need to have an operating 
system installed before they can be executed. 

A final type of program is a custom application program. A custom application is a program which has been 
developed specifically for a particular problem or process. For example, if I was a manufacturing company, I may 
want a program that specifically manages the inventory of a product which I produce. This product and the process 
that develops it may be so unique that a packaged software application does not exist. By creating my own 
software application, I can create a competitive advantage over my competitors by offering my product at a lower 
cost because of the development of this custom application (it costs me less to manage inventory because of the 
application that was developed). Custom application programs need to have an operating system installed before 
they can be executed. 



WORKING LIKE A PROGRAMMER: THE PROCESS OF CREATING PROGRAMS 
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In Practice: SDLC - System Development Life Cycle in Detail: SDLC stands for system development life cycle. It is a 
methodology/process used by people who work in information technology to solve problems to providing effective 
and efficient solutions. It remains as the foundation for planning and implementing most systems projects (i.e. 
application programming). If not for programming, SDLC can also be used for hardware and networking projects. It 
represents a common tool that you will frequently encounter in working with computer systems. 



System Development Life Cycle: I tell students that using SDLC is an exercise in common sense. Do not let the term 
intimidate you. It sounds very complicated but in fact is a very logical way of approaching and solving a complex 
problem. In short, SDLC is a "rifle approach" (versus and unorganized shot-gun approach) to quickly and 
successfully solve a problem. It includes four common sense process steps to solve any type of problem (1) define 
the problem and assign it a priority (2) analyze the problem particulars and identify possible solutions, (3) design a 
solution and (4) implement your solution. This process is not just for computer programming. It should work on 
everything from fixing a flat tire to building an operating system. It works because it documents a plan of attack 
that logically focuses on a problem and identifies alternatives. 



SDLC CONTAINS THE FOLLOWING PHASES: 



1. Planning - Defining the problem and prioritizing against other programming projects 

2. Requirement Analysis - Fact finding problem specifics through observation, questionnaires and interviews. 

3. Design - Develop problem alternatives, and models to represent problem and solution 

4. Development - Coding and testing of the program 

5. Implementation - Installing the program and training the user 

6. Maintenance - On-going changes to the program (maintenance) 



SDLC contains a series of steps that must be completed as phases. For example, the first phase needs to be started 
before the second phase and the third phase is to be started before the fourth face and so on. Even though there 
is this dependency there is also no reason why there cannot some be parallel activity. By this I mean one phase can 
start before the preceding face is completely finished. SDLC has been called a "waterfall" approach because one 
phase flows into the next phase. 



Key Concept: SDLC can loosely be defined as exercising common sense. Most problems, computer or non- 
computer, can be solved by using a logical common sense approach to solving the problem. After all, aren't most 
problems solved by getting the facts, designing a solution and implementing the solution? It could be a math 
problem, a science problem or a problem with your car, the approached suggested in SDLC could work for them all. 



PROGRAM DEVELOPMENT PROCESS 
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To become a successful programmer, you need to begin to work like a programmer. To work like a programmer, 
you have to start using the program development process. Even though the process name sounds rather imposing, 
the program development process (PDP) is actually very straightforward and very much common sense. PDP is a 
sub-process of SDLC that becomes part of several of the steps of SDLC. 

Program Development Process (PDP) - you can think of the program development process as standardized set of 
steps used to provide a logical, common sense approach (or process) to solving a difficult problem with a computer 
application. PDP is a checklist that ensures that the steps of building a program are followed so that no important 
step is omitted or taken out of order. This process has long been used by programmers as a professional standard 
because of its simplicity, effectiveness and consistency. 




Figure 4: Program Development Process is outlined as a five step sequential approach. Maintenance is reflected as 
a separate process that can occur one or more times after the original program is implemented. 



Key Point: SDLC and the PDP are not industry standardized processes. In other words, you may find different 
various versions of each depending on the development process you are using. The PDP, in particular, is a process 
created specifically for the eBook as a composite of other similar program development processes used in the 
industry. If your SDLC and PDP phases look different that in other textbooks, look at the activities in each phase 
and you will see that even if the phase name is different, the spirit of each phase is the same. 
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status Check: 

What are the different types of computer programs? 

Can you execute an application program without an operating system? 

Why was it written that we are concentrating on custom applications in this eBook? 

What are the phases of SDLC? 

How is PDP similar to SDLC? 

AN EXAMPLE: USING THE SDLC AND THE PROGRAM DEVELOPMENT 
PROCESS 



PROBLEM: PROGRAM LOGIC IS NEEDED TO DEVELOP A PROGRAM THAT WILLS 
AVERAGE CLASS GRADES. 



PROGRAM DEVELOPMENT PROCESS PHASES 



PLANNING 

Start with a problem statement: I need a program that will calculate the test scores for a class of 15 students and 
tell me the average test score. 

REQUIREMENTS ANALYSIS 

*Fact finding or requirements analysis (done by interviewing the end user): Do you have an example of how you 
want the average number displayed? Do all of the test scores need to be displayed or just the final average? How 
would you like to input the scores? One at a time or all at once? What if there are less than 15 scores? 

Design 

• Conceptual design: Conceptual design usually takes the form of a logic model that lays out the ideal logic 
structures to provide a solution. In conceptual design, we will program the expressions needed to 
calculate the average along with the logic necessary to accept the inputted values. 

• Detail design: We are ready to code our solution using a programming language. We take the conceptual 
design as a starting point and using the syntax options of the programming language, code the logic 
structures into programming language structures. 

• Testing: We will perform unit tests as we go. Unit testing is used to test sections of the entire program. A 
system test will be performed at the end of the process to make sure our scores are calculating correctly 
and that any errors are flagged for the end user. 
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IMPLEMENTATION 



• Implementation: During implementation, we move Into production the test average calculator program 
on to the PC of the person using it. The program is complete and ready to use. 



MAINTENANCE 

• Maintenance: No program is written once and not revisited without some changes. No sooner than the 
user started to use this program then did they decide that it would be useful in their other classes. The 
other classes have different numbers of students so that a program that score 15 tests needs to be 
changed to a program that scores however many tests the user has to grade. We now start back up at the 
problem statement and move through the phases once more for this program maintenance. 

OTHER PROGRAM DEVELOPMENT PROCESS CONCERNS 



The following processes and activities are not defined specifically to one program development phase but in fact 
can be a part of several or all of the PDP phases. 



DEPLOYMENT: 

Deployment concerns the techniques that will be used to deliver your program to your users. Deployment is 
affected by options available for the distribution of software (i.e. some user's computers will have to be updated 
by CD-ROM or updated via the Intranet/Internet) and the type of program (Internet or Desktop). You'll also want 
to consider if automatic configuration is required by your program. This might include placement of an icon on the 
user's desktop or placement of the program in the programs start menu (in the case of Microsoft Windows). 

Internet applications have different deployment concerns and require planning throughout the PDP process. 
Programs do exist for the programmer to assist in deployment. Understanding the features and functions of these 
products early in the detail design process can make deployment much easier when the project reaches 
implementation. 



TRAINING/DOCUMENTATION: 

It is very easy to forget about training and documentation until the project is complete. Many times training and 
documentation is either ignored or given no consideration at all. You need a look this task as one of the ways to 
ensure your programs success. If users cannot understand how the program works, they will both reject the 
program out of frustration or turnaround and request a number of modifications which will only lengthen the 
amount of time and cost needed to complete the software. 



Programming Tip: Many programming languages support special documentation tags (these tags are similar to 
HTML tags, if you are familiar with web page formatting) which can be added during the coding process so that 
documentation can be created automatically when the program is complete. 



Training is sometimes the responsibility of the programmer and is sometimes the responsibility of education and 
training staff. Even if it's the responsibility of another group, as the programmer, you'll certainly have to be actively 
involved in describing how the program operates and what prerequisite skills will be necessary for full use of the 
programs features. 
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PROJECT MANAGEMENT: 



Not all programs are contained in a single file and programmed by one programmer. Depending on the size of the 
application project, you may be part of a team who is developing a new system. This team may be developing 20 
are 30 programs independently of one another but programs which will need to function in concert with one 
another at the project's conclusion. To facilitate an effort of this magnitude, typically a project manager is assigned 
to the project. The project manager will likely use project management software. Project management software 
packages are designed to improve the productivity of the entire team by keeping track of who's doing what and in 
what sequence. It helps ensure that programs are developed on schedule and that one programmer is not held up 
waiting for the work of another programmer to be completed. 

Status Check: 

What are the main tasks in conceptual design phase of PDP? 

Why are deployment, project management and training outside the tasks in PDP? 



CHAPTER CASE STUDY: CACTUS BOOKS AND TAPES 

Each chapter will have a common case study to integrate topics covered in the chapter. Cactus Books and Tapes is 
a fictitious small business run by two sisters who are just starting to incorporate technology to meet their growth. 
Like most small businesses they are trying to use Internet to improve customer service and increase sales. The case 
study will also parallel the assignment cases studies found at the end of each chapter. 



CACTUS BOOKS AND TAPES 

Cactus Books and Tapes (CBT) was opened in 1998 by two sisters who saw a business opportunity in the sales and 
rental of audio tapes. The business began with a small store in a strip mall near a large office complex. The traffic 
to the store has always been good and because of the prudent planning of Christina and Lois Chavez, the store 
expanded from the selling of tapes to also books. The theme of the bookstore is still focused on self-help materials 
but the Chavez sisters carry best sellers and do a good business in custom orders of books and tapes. The store 
added a new location last year and the business continues to grow. The new store includes a coffee bar and an 
area for customers to read and enjoy a cup of their favorite tea or coffee. Many of the CBT customers would like to 
request custom book orders on the Internet instead of driving to the store or having to worry about someone 
being available to answer the phone. The sisters see the development of a web page to accomplish this as a critical 
project for continued store success. 

The store is organized as a partnership between the two sisters. The business has combined retail space of 25,000 
square ft (10,000 feet at first location and 15,000 square feet at the new location). Christina manages the original 
location and supervises the accounting for the business (accounts payable, accounts receivable, payroll and human 
resources). Lois manages the new store and has been focusing her attention on managing the stores new coffee 
bar. The business has two assistant managers at each store (day and evening shifts) and has approximately 35 
employees combined. The store is open 6 days a week from 9 a.m. to 9 p.m... Sales volume from both stores is 
approximately $750,000 dollars per year. 

Since neither Christina nor Lois has extensive computer experience they have contracted your expertise as an 
outsourced employee who will help them in the design of their Internet book order service. Outsourcing is an 
excellent way for an employer to be able to work with and evaluate the knowledge of a potential new hire. Since 
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CBT has a good benefits plan and competitive salaries, this is an excellent opportunity for you to get on to the 
ground floor of a growing small business. 

Your first challenge is to map out a plan of action so that the design of the Internet book order service will be 
successful. You will use the steps outlined in the program development process and with SDLC to let the Chavez 
sisters know what steps need to be performed to complete the project. 

To do this you have decided to use an SDLC diagram to provide a high level picture of the overall plan and the 
program development process to outline the specifics required to build the programs used to capture Internet 
book orders. 

USING A PROGRAMMING LANGUAGE 

Taking your program logic and converting it into a compiled program so that it can be executed on the PC requires 
several steps and various tools. First and foremost, the programmer must decide which computer language they 
will implement their solution in. Each computer language is similar and is different. Most computer languages are 
similar in that they use common structures (the structures we will be learning in this eBook) and different in that 
they use different keyword statements and syntax. 



Tip: The Internet is a great source for researching the different programming languages. Many languages are in the 
public domain and programming tools exist to learn these languages at no cost (providing you have a personal 
computer). 



Background Information: Programming Languages 

[There are perhaps hundreds of programming languages available to the programmer across various hardware 
platforms and operating systems. Some of these programming languages were designed for very specific kinds of 
applications (i.e. scientific or business) and many others or designed to be used in a more general sense (all types 

I of software applications). 

Many computer languages have been standardized so that their use can be applied across multiple hardware 
platforms and operating systems. Popular languages such as Java are available on everything from a 
supercomputer to a cell phone. The recent trend in new programming languages is to create languages that 
support structured and object oriented programming (both which will be covered extensively in this eBook) across 
multiple operating system platforms. For example, in object orientated programming there is a great advantage in 
being able to create class objects (blocks of logic statements) that can be reused over and over again in multiple 
programs. Since programming has always been a primarily labor intensive activity, any developments, like code 
reuse, which allow programmers to create code faster and of higher quality is seen as important. Java and C# (C 
sharp) are two contemporary languages which were designed specifically for programmer productivity (with code 
reuse support) and for support across multiple computing environments. Older languages, such as BASIC, have 
continued to be modified in upgraded to support several of these same code reuse capabilities to also improve 
programmer productivity. 

Most modern programming languages also support program development software to make the programmer 
more productive. This programmer's software development environment is typically called an IDE. IDE stands for 
Integrated Development Environment and includes the ability to create and edit source code from program logic, 
compile code to remove syntax errors in language statements, support a visual debugger which helps to isolate 
logic errors and finally a linking environment to join compiled modules into an executable program. This sounds 
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complicated but in reality the IDE allows us to author the program and then create a compiled file that has 
converted our programming statements to codes that the operating system can execute. 

The IDE Is the programmers' toolbox and contains software that will make the programmer work quicker and more 
effectively. Although the only computer language we will specifically use in this eBook is PYTHON, it is appropriate 
to talk about some of the various ways contemporary computer languages facilitate the creation of executable 
programs. We will have samples of Java and Visual Basic also included from time to time within the eBook. 



Integrated Development Environment: Since programming is a labor intensive activity, the programmer needs 
tools just like a carpenter needs a saw. The IDE provides the tools you need to become a more efficient 
programmer. The IDE will at a minimum include a programming source code editor, a run-time debugger to help 
find errors, a compiler to create an executable version of the source code and usually on-line help with 
programming language documentation. 



UNDERSTANDING PROGRAM LANGUAGE STATEMENTS AND SYNTAX 

As mentioned earlier, coding your program with program language statements follows your logic model. Once you 
have the blueprint complete and the logic organized, you are ready to start building with the programming 
language. The program language will sequence the instructions you are sending to the operating system to 
perform the tasks of your program. 

Program language syntax rules are the rules of grammar for a particular programming language. Some 
programming languages require that each statement end with a semi colon. Some programming languages have 
specific requirements as to how variables must be declared and referenced. All programming languages have 
slightly different syntax rules just as French is different than Spanish is different than English. Just like it takes time 
to understand the syntax of Spanish, programming language syntax also takes time to learn. 



Background Information: Troubleshoot Skills and Debugging your Program Logic - Most programmers spend the 
bulk of their time maintaining existing software. Because of this it is important that you are able to read and 
understand other programmer's logic and programming statements. It is just as important that you document your 
programs and use accepted standards to ease the ability of other programmers to understand your work. 



Debugging the program is the process of examining program logic for errors. Programming errors and errors in 
general have been called bugs. The origination of the term goes back to the very first computers when a gypsy 
moth flew too close to a vacuum tube and caused the computer to fail. Since the problem was truly a bug (insect), 
the computer operator coined the expression "bug in system" to describe the problem. The word caught on and 
computer problems have been referred to as bugs ever since then. The act of removing bugs (or problems) from 
program logic is called debugging. Software that helps to remove problems is called a debugger. A more traditional 
word for this activity is troubleshooting which means the same as debugging. 

As you take your first programming class, experience with programming syntax can be one of the more frustrating 
activities. It's not unusual to stare at a program statement for fifteen minutes trying to understand the syntax 
error, only to have a more experienced person find what is missing, in less than 30 seconds. Whereas the English 
language allows us to have lapses in our use of grammar, a computer program is very specific and as mentioned in 
an earlier section of this chapter, computers must be told exactly what to do or they will not be able to do it. The 
compiler and interpreter will report syntax errors to the programmer and will not let program execution continue 
until the syntax error is fixed. We will see evidence of syntax rules as we work with PYTHON to develop our 
program logic. 



Programming language Syntax: All new programmers with remember their first syntax errors with great 
fondness. ..NOT! Learning the syntax (or grammar) of a programming language can be compared with learning any 
new language. It is much easier reading at a foreign language then it is to speak it. This is because to speak it we 
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have to have a strong knowledge of the languages syntax. It takes time and it is frustrating by rest assured, we 
have all been there. 



Related Subject: Programming Patterns 

There has been a lot of work done recently in studying programming patterns. Patterns are blocks of logic (later 
converted to programming statements) that represent common logic blocks. The logic statements together would 
represent a task that you would use again. Maybe a pattern might be reading a file until you have reached the last 
record. Common logic patterns like reading a data file is the type of logic block that would be easily reused across a 
variety of different programs. 



EXECUTING THE PROGRAM 

Creating a file containing a series of programming language statements in not enough. The operation system 
cannot recognize program statements in their original "English" like format. A source code program must be 
converted to a format that the operating system can execute before it can be used. 

Executing a program is done in two ways. Usually depending on the programming language, your program source 
code (program language statements) will be either compiled into a new file containing instructions recognizable by 
the operating system or read line by line by a program interpreter. Rather than creating a new file of compiled 
program language statements, an interpreter creates no new file but executes each line one at a time. 

INTERPRETER BASICS 

Aside from compilers which create executable machine code, many languages also support interpreters. It is 
important to note, some programming languages can only be executed with an interpreter. What this means is 
that rather than creating (compiling) a file of machine code instructions executed by the operating system, the 
interpreter is a program that reads the source code line by line and converts it into machine code instructions. 
Interpreters offer some advantages when writing new code but have typically been shunned for production 
environments since interpreted code typically runs slower then compiled machine code. To illustrate this, I would 
use the analogy where if you are visiting a foreign country and you do not know the language you would have to 
have every statement you spoke interpreted. You would have to wait for your communication to be interpreted 
and you would have to wait for the response to be interpreted. With a compiled program, the machine code is 
directly fed into the operating system since the translation has already completed. 



Executable Machine Code: Computers do not understand English but they do understand ones and zeros 
(electrical current that is either on or off). The source code instructions are converted by compilers or interpreters 
to binary code instructions that the computer can understand. Until the program is converted to machine code, 
you program cannot tell the computer how to do anything. 



Interpreters: An interpreter translates the programming language source code to binary machine code. A 
computer interpreter converts a computer language to machine codes each and every time it executes. It also has 
the reputation of running programs slower because of the every time translation but has been used by 
programming environments like Java and Microsoft .NET (virtual runtime interpreters) to allow programs to be run 
on multiple operating systems with modification ("write once run everywhere".) 



Program Development Process Phases | http://laptoppress.garymarrer.com 



COMPILER BASICS 



We have already spent some time discussing the compilers importance to the IDE and comparing the compiler to a 
program interpreter. Compiled code is typically saved into a file with a file extension of .exe. For some 
programming languages, the .exe file is standalone and requires no other programs or libraries for program 
execution. For other programming languages, the .exe file is designed to work with other libraries of machine code 
that must exist on the computer. Most comprehensive IDE's include the packaging and deployment tools that will 
bundle all the necessary files for the application to run on a different personal computer. This packaging tool 
would not only include the IDE created .exe file that also any libraries of machine code necessary to run that 
program. 



Compiler: Much like the Interpreter converts computer language statements into executable machine code, a 
compiler also converts source code into machine code. A compiler converts the source code into an .EXE file that 
can be run by the operating system. Compiled programs run faster than interpreted programs since the source 
code to machine code conversion was done in advance and place in a file that can be executed by the operating 
system. 
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Figure 5: Process of Creating an Executable Program witli a Compiler 



VIRTUAL RUN-TIME MACHINE FUNDAMENTALS 
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A virtual runtime machine is somewhere between an interpreter and a compiler. Typically, a program must first be 
compiled into some intermediate language that will be recognized by an interpreter (also known as a runtime 
machine). The intermediate language is not quite machine code but his been created in a way to optimize it 
performance on the interpreter. The Java, Java Virtual Machine (JVM) and Microsoft's Visual Studio. Net Common 
Language Runtime (CLR) use runtime virtual machines to execute programs. 



Virtual run-time machine: Here we have a different type of Interpreter. This Interpreter uses pre-compiled files 
(not compiled for an operating system like a traditional compiler) to send machine code instructions to the 
operating system. The pre-compiled files for virtual run-time machines can be run on any virtual runtime machine 
making them executable on different operating systems. 



There are benefits in creating programs that can be executed under a virtual run-time machine. It is now possible 
to compile a program in a Microsoft Windows environment and run that same compiled file on an Apple 
Macintosh running the OS 10 operating system. Normally with compiled programs, it would not be possible for the 
same program to run across multiple operating systems. The term "write once run everywhere" has been used to 
categorize programming languages that use virtual run-time machines. Both the Java Virtual Machine and the 
Common Language Runtime have a specification that allows virtual run-time machines to be created for not only 
computers but also devices like cell phones, personal digital assistants (PDA) and even smartcards. This allows the 
programmer to use their personal computer to create programs for other computing devices like cell phones and 
PDA's. This is another way of extending the productivity of the programmer. 

Status Checl<: 

V\/hat benefits and weaknesses of interpreted programs? 

How can a programming language that uses a virtual run-time interpreter be an advantage for the software 
developer? 



'putting it to use 



The intent of this section is to introduce the new programmer to standards and techniques frequently used by 
professional programmers. Topics in this section relate to concepts introduced in the chapter but with a more 
vocational or occupational focus for students considering a career in programming. 




LIFE AS A PROFESSIONAL PROGRAMMER 



On a daily basis, programmers are designing new programs or maintaining existing applications. Based on past 
history, most of the time you'll be maintaining existing programs. Although you'll find in your programming classes 
that you'll typically be developing a new program with each assignment, most professional programmers are kept 
busy maintaining existing software. Part of this is because of the labor intensive nature of programming and the 
cost it takes to develop new systems. Put yourself in the place of the owner of a company or its shareholders, you 
would want to take a new program and spread its expense over as much time as possible. Just like any investment, 
a computer program is a company asset and the goal of management should be to maximize the return from that 
asset. This may mean using an existing program even when a better one could be written if the return on the 
original program is still favorable. This is the same reason most of us do not buy a new car every year. You will on 
occasion be involved with the development of new systems. Companies need new software to remain competitive 
and even existing high quality software sometimes has to be replaced because of new requirements. 
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Key Concepts: Programming is a mix of using your creativity and your problem solving skills to create something 
from nothing that can be admired just like we admire good music or art. 

So from one standpoint it's important that you are able to design new program logic and write effective programs. 
As a new programmer, it's probably more important that you are able to look at someone else's program logic and 
understand how to apply the necessary changes. 



Background Information: A Maintenance Programmer - Your Goal!: I have often told the programming students in 
my entry level programming classes that my goal (and also theirs) is to have them come out of the class as a 
competent maintenance programmer. I say this because most of the time this will be what they are going on their 
first job. 



Programming maintenance could involve the repair of an error in the program or the addition of a new program 
feature. 

All professions have activities which are considered benchmarks for success. If you're a major league baseball 
player than your benchmark for success is probably your batting average or the number of home runs hit. As a 
programmer, your benchmarks are writing high quality programs that run with the highest standards of 
performance. Your documentation and design should be clear and concise. Your knowledge of technology is up to 
date and you're committed to learning new technology as it is developed. Peer respect on the job will come from 
being able to take problems and systematically and professionally convert them into software solutions. 

Programming exercises your mind and challenges you to think. Meeting that challenge and being successful in 
developing solutions with a computer can be very rewarding. If you ask any programmer how they felt about their 
career decision, I think most would tell you that they have found it to be an extremely rewarding career. 
Programmers are considered professional staff. As a professional, their given a great deal of latitude to set their 
schedule, pick their projects and work with minimal management supervision. Most programmers would tell you 
the programming is a very good career choice. 



Key Concepts: Becoming a successful programmer means that one needs to learn the standards and best practices 
used by successful programmers. These practices include learning techniques for creating program logic. Many 
times these best practices are not given the appropriate attention in programming classes since programming 
classes need to focus on the syntax of the language being taught. The focus in this eBook will be on structured an 
object oriented programming but the examples and exercises will allow you to perform some programming with 
an easy to use the programming language called Python. Don't be alarmed that you are being exposed to a 
programming language so soon. Python is a tool that will help you get the kind of feedback necessary to determine 
if your program logic designs are correct. It is an added bonus that we will be able to have exposure to a powerful 
programming language as part of the eBooks' coverage. 



Best Practices: The importance of Good Program Documentation 

As I mentioned earlier, most programmers spend a great deal of time maintaining other programs. It doesn't take 
long for a programmer to appreciate good program documentation. Without program documentation, 
maintenance on someone else's program could take hours instead of minutes. If the program has unusual logic 
without program documentation, it seems like it would be easier to build the program from scratch rather than 
analyze the confusing work of another programmer. All programming languages have a special statement or syntax 
to leave comments in a program. These comments might be a paragraph to explain a particularly tricky piece of 
logic or just a statement to accent the timing of the logic. 
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TIP: Even though it is easy to ignore documentation when one is deep into coding a program, it is much easier to 
place program comments in your code as you go then it is to go bacl< later and try to remember what was 
important about that part of the program logic. There is probably no so thing as too much program documentation 
unless the programming language is interpreted in which case the program comments should be placed the end of 
the program after the programming language statements. 

I have included below some sample program documentation for a PYTHON program. The # signs are used in 
PYTHON to add program comments to a source code. The # sign (along with the text to the right of the #) is 
ignored by the interpreter and not executed. There are typically no rules or standards regarding comments but 
most programmers will usually add a sentence or two for a quick explanation. 

#Gary Marrer 

#Chapter 1 - Comment Example 

#variable address stores a customer's address 

address = "1 Main Street" 

#Subtract cost from sales to calculate profit 

profit = cost - sales 

It is important to note that I am talking of programming documentation in this section of the chapter. There are 
other forms of documentation that you may be involved with as the programmer. You may be involved with user 
documentation for the end user or operator documentation for the Information Services staff. Many organizations 
have documentation standards which all staff must abide by. 

Related Subject: The Myth of Self Documenting Code - Many programmers who ignore good program 
documentation will use the excuse that the programming language is one that is self-documenting. This is 
especially true of programming languages that have extensive libraries of built in routines that cover most of the 
common programming logic scenarios. This is a misconception. Even languages with a limited set of statements 
and keywords need to have program documentation added (via comments) to ensure that the logic of the program 
is understood when the program is revisited at a later date. 



CHAPTER REVIEW 




Chapter summary, highlights, key terms, short answer questions, quizzes and case studies to reinforce topics 
covered in this chapter. 

CHAPTER SUMMARY 

After finishing this chapter you should understand and in some cases, demonstrate the following topics: 



Define program logic and computer program. 

o Computer logic is the conceptual design of a program solution. One the conceptual design is 
complete the logic is converted into a source code program developed with a programming 
language to implement the solution on the computer. 

Describe the relationship between computer programming logic and computer programs. 



Chapter Review | http://laptoppress.garymarrer.com 



Copyrlgfilct) malanal 



o Problems solved on the computer with computer programs first start with a plan that is 
documented as logic in logic models. 

• Explain the process of solving a problem with program logic and a computer program. 

o The process of programming requires that you (1) identify the problem, (2) model the solution, 
(3) implement the solution with a programming language and (4) run the program to derive the 
solution. 

• Describe why program logic is modeled with pseudo code and flow charts before being transformed into a 
program. 

o In absence of a plan to design a solution, a design leave out important details to built the 
programming instructions necessary to write the program. 

• Recognize the importance of program development methodologies like the program development 
process and the system development life cycle to develop computer programs. 

o SDLC has long been used to guide systems staff through a systematic process for problem 
management. With SDLC the process phases are defined as planning, requirements analysis, 
design, development, implementation and maintenance. 

o PDP is a program development process specifically created for program development. Like SDLC, 
PDP is a process with a set of phases. The phases of PDP are problem statement, requirements 
analysis, conceptual design, detailed design and implementation 

• Describe the roles and responsibilities of programmers and the processes programmers use to create 
programs. 

o Programmers write programs and are an important part of very organization and recognized as a 
professional with limited need for direct management 

o Programmers use tools like Integrated Development Environments (IDE) to make them more 
productive in what has traditionally been a labor intensive activity. 

• Differentiate between compilers, interpreters and virtual run-time machines in regards to building and 
executing programs. 

o Programs need to be compiled to remove computer programming language syntax errors and to 
create a machine executable file of the programs instructions. 

o Some programming languages use interpreters or virtual run-time machines to convert 
programming language source code statements into machine executable instructions executed 
by the operating system. 



CHAPTER KEY TERMS 



Compiler 

Computer Programs (Program) 
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Computer Programming (Programs) 
Debugger 

Executable Machine Code (.EXE) 
Flow Charting 

Integrated Development Environment 
Interpreters 

Program Documentation 

Program Language Syntax 

Programmer 

Programming Languages 

Programming Logic Structures 

Pseudo Code 

Runtime Virtual Machine 
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PART 1 INTRODUCTION TO PROGRAMMING 



CHAPTER 2 INTRODUCTION TO PROGRAM LOGIC 



IN THIS CHAPTER, YOU WILL LEARN HOW TO: 



1. Explain why it is important to use logic modeling tools when designing a software program. 

2. Describe the advantages and disadvantages of using flow charting and pseudo-code to design a program. 

3. Recognize the components of a test plan and the benefits of developing and following a test plan. 



PROGRAM DEVELOPMENT WITH LOGIC MODELING TOOLS 



Why do we construct logic models to create computer programs? This is certainly a very valid question and one I 
have heard many times from programming students. I've had many new student programmers who have been in a 
rush to program. This is a very natural reaction. Our enthusiasm to get started along with the uncertainty of 
learning a new subject, drive our desire to create our first program. It is difficult to stay patient as we move 
through the topics of flow charting and pseudo code knowing that PYTHON IDE is ready to start programming with. 
Resist the temptation for a little while longer as we again discuss the discipline of programming. The adage 
"anything worth having is worth waiting for" is very appropriate explanation of where we are at in your 
programming training. A little patience now is important as we build a foundation that will help you become a 
more effective and efficient programmer. 

In chapter one, I talked about the discipline of programming. I explained that having discipline as a programmer 
meant approaching programming with a professional standardized process. This discipline has been used by other 
programmers and has evolved over time from numerous successful programming projects. This is not unlike the 
professional standards and processes developed by accountants, lawyers, engineers and other professionals. 

There are many analogies I could use to demonstrate how program discipline is exhibited and why it is important. I 
have already used one scenario in chapter one. There I discussed building a house from scratch using building 
supplies from the local hardware store. Without following the standards used by professional builders (blueprints, 
accepted construction techniques, building code regulations), we might end up with something that looks like a 
house (a structure with a roof and four walls) but it's unlikely that it would be of the quality that was found in a 
house built by a professional. It might have an unsafe design. We might not be able to remodel or repair the house 
later on because of its non-standard construction. It would a structure that would probably not stand the test of 
time like a house built using established standards and techniques. 

How about another analogy? Are you the kind of person who doesn't like to read directions? Do you buy a product 
from the store and instead of reading over the assembly instructions you simply start putting things together 
based on the picture on the box? When it comes to installing new software from a CD-ROM to your personal 
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computer, do you just place the CD-ROM in the drive and tal<e all the defaults or do you read the instructions on 
how to install it properly. Most of the time, the software installs okay. Sometimes the original install seems 
successful and after awhile you realized the software was not installed correctly and you have to reinstall again. 
Normally the reinstall is not a problem but you had customized your software settings, the new install will 
probably wipe them out so that you will need to reconfigure them again. This will be the penalty for your haste. 
This is why the discipline of programming is so important to becoming an effective programmer. 

Do not take the time to use good programming processes during your project (like building logic models first) and 
you might find a serious problem later on after the program has been in use. This is the worst kind and most 
embarrassing type of programming design error. Programs that require a lot of rework and repair just after 
installation are poorly designed programs and a sure sign that programming discipline was not followed. 



Figure 1: A disciplined approach to programming. Start with a well defined problem, document the model and 
build the program. 



MODELS - A PERFECT WORLD SOLUTION 



Models should represent the ideal solution. A model should look at the requirements and without bias; identify 
what would be the best of all possible logic design. Sometimes a model is called the conceptual (ideal world) view 
with the actual program is called the physical (or real) view or implementation of the logic. Will the defined model 
reflect the final solution? Maybe and maybe not. Many times in ideal solution may be difficult to duplicate with a 



A 



Disciplined " Approach 
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programming language. Sometimes an ideal solution may not be the best performing solution or may not be the 
most efficient. Again, different programming languages have different strengths and weal<nesses. I let students 
know that when the programming is done the program needs to meet the requirements of the problem and not 
necessarily requirements of the logic model. 



Model: A model is an abstraction of reality. When we model a design we use the requirements to put together a 
solution. The model allows us to experiment and fine tune our vision of the solution until it's correct. You need a 
step before programming starts to ensure that no requirement is left unnoticed. Think of your logic model as your 
blueprint as you design the "perfect" program. 

Logic Path: a logic path is simply a sequence of instructions or statements. Sometimes a path of logic statements is 
also known as an algorithm. A logic path or algorithm is a set of steps/instructions to perform a particular task. As 
you'll see in future chapters a program is a series of logic paths connected to solve a larger problem. 



There is a rich selection of modeling tools available to the programmer. Some of these tools use a manual process, 
some tools are a combination of manual and automated processes and some tools use a completely automated 
process that create program code at the end of the modeling. 

Manual and Automated Processes: manual processes are what we did before computers. The bookkeeper who 
used a manual process had a ledger book and an adding machine in which she kept track of the company's 
transactions by writing those transactions in the ledger book. When the job of bookkeeping became automated, 
bookkeeping functions were performed by a computer program where the disk drive saved the data and the 
program ensured that transactions were calculated correctly. It is important to put in perspective that just because 
a process is manual does not mean that it is bad or that it needs to be automated. Some tasks are still better 
performed manually. 



Background Information: I'll take mine manual thank you. - 1 have a friend who has every new technology as soon 
as it is available. There is nothing he would not adopt if a computer was attached to it. His last investment in 
technology was a computer in a watch. The watch was the size of a shot glass in circumference and about a half an 
inch thick. Not very practical. Seems to me like a lot of money and effort for just something that keeps time. As you 
work with technology, it is easy to not critically look at a problem and fairly assess whether or not it is better off on 
a computer. I also wonder why so many use electronic checkbooks. There are certainly some advantages in using a 
computer for keeping track of a budget but the logging and printing of checks maybe a little more than necessary 
when a check register and a pen also do a pretty good job. I always liked to think that the computer worked for me 
and that I did not have to work for the computer. Make sure that you always look at the task to determine if it 
would benefit from an automated process 



The modeling tools that we are using in this eBook fall in the category of a combination of manual/automated and 
just automated. In the case of pseudo code and flow charts, these models can be created on paper, manually, or 
can be created with the assistance of drawing software or text editors. 



TYPES OF LOGIC MODELING TOOLS 



Software has certainly lagged hardware in relation to innovation and technical improvements. Software still 
remains labor intensive without too many changes over the last 40 years. One area where software has seen some 
improvements has been in the creation of software tools to assist the programmer in developing programs. The 
(IDE) integrated development environment (covered later in this chapter) which allows the programmer to edit, 
compile and test his programs is one tool that has made the programmer become more productive. 

There are techniques to assist the programmer and modeling logic. Perhaps the most difficult a model to use is the 
flow chart. Although the flow chart is easy to read is not easy to assemble. Unless one has a lot of practice and a 
fair amount of artistic expertise, using a flowchart symbol template with pencil and paper can be a very slow in 
frustrating process. 
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One of the premier tools used for a variety of graphical logic models (including UML diagrams introduced later in 
the Object Orientated chapters) is called Visio. Visio is a product sold by Microsoft Corporation and sets the 
standard for easy to use graphics generation programs. With Visio, you can simply drag flowchart logic symbols 
from a virtual template to the drawing area and quickly and easily label that logic symbol and connect it to other 
logic symbols. 

FLOW CHARTING 

Certainly the most obvious benefit of flowcharting is its graphical nature. Unlike pseudo code, flowcharts consist of 
standard flow chart symbols connected by lines where each symbol reflects an operation of logic. In addition, each 
symbol not only is standardized to represent an operation (i.e. an IF decision statement) but also labels the logic 
operation with a short explanation what the logic instruction performs. 

Flow Charting Symbols: Flowcharting is a standardized set of symbols that represent different types of logic 
operations. The symbol shapes are standardized and the way they are read (top to bottom) is also standardized to 
the flowchart diagram. The flowchart represents a graphical view of a logic model with each symbol representing a 
logic step. 



FLOW CHART SYMBOLS 

• Rounded Rectangle: The rounded rectangle is used to show the start and finish of the logic flow. This 
symbol is called the terminator symbol. 

• Circle: The circle is used to connect drawings that span more than one piece of paper and help to connect 
the logic paths from page to page. The circle shows the end of the drawing on that page and has a 
number inside it. The next page of the diagram starts with a circle with that same number. This helps to 
tie the two pages together and when the logic ends on one page, it should be picked up in the circle on 
the drawing for the next page. 

• Rectangle: The rectangle is used to show a single step in the model logic. Some activity (i.e. expression, 
calculation, etc.) 

• Diamond: The diamond is used to represent a decision. The outcome may be true or true/false and is 
usually implemented in program code as an IF statement. 

• Parallelogram: The parallelogram represents logic input or output (i.e. reading from a keyboard or file or 
writing to a display or printer). 

• Lines: Lines show the movement of logic and the direction of information from symbol to symbol 
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Figure 2:Flowchart Symbols 



FLOW CHART RULES: 

All modeling environment have standards and rules that need to be followed. In some cases, the rule is necessary 
for the diagram to work and in other cases the standard is there so that other programmers can look at the logic 
model and see the same logic solution. I have used the analogy of a blueprint to help understand what a logic 
model is for the programmer. Blueprints are standardized. If they were not then one blueprint might be 
understood differently from one home builder to another. 



• Each symbol will have one line coming into the symbol and one line going out. The exception is the 
diamond (decision) which can have two lines. 
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• Lines should never cross 

• Every Symbol should be appropriately labeled with a short explanation of that logic step 



Key Concept: Flow Chart Symbol Labels - Although flow chart labels tended not to be as a verbose as pseudo code, 
the labels tend to be very much like pseudo code and that they provide an English like statement to express what 
the symbols logic needs to accomplish. One could probably construct pseudo code from a flow chart simply by 
pulling the text from each symbol label. 



THE ADVANTAGES OF FLOW CHARTS 



The flowcharts greatest advantage comes from its simplicity. They are both simple to understand and create. Since 
most programmers (and most people in general) tend to prefer concepts explained visually, the flowchart is 
perfect. Seeing the logic in front of you seems to make a discussion of the programs purpose and steps much 
simpler. Less intimidating then pseudo code, which itself is also very easy to understand but, still consists of 
statements which must be read. With flowcharting applications like Microsoft's Visio, even people with the 
weakest of artistic skill can put together a flowchart quickly and efficiently. A final advantage of flowcharts maybe 
the less bias nature of flow charts over pseudo code. With pseudo code you are still creating a program and 
programming syntax should not come into play when designing the model. With flowcharting there may be more 
of a spirit of "brainstorming", creating that perfect world solution, since the flow chart model is dramatically 
different (i.e. no statements) than the computer program. Flowcharting might be a better tool to reach an 
unbiased ideal logic model solution. I have always felt that it was much easier to formulate a high level plan with a 
quick drawing then with the English like statements of pseudo code which seems to draw you into the details too 
soon. 



THE DISADVANTAGES OF FLOW CHARTS 

Flowcharts have three disadvantages. The first disadvantage comes from the difficulty in drawing sophisticated 
logic without spanning several pieces of paper. Either the symbols need to be resized to a microscopic level when 
looking at complicated logic or the reader will need a large table to line up the multiple pages of the flowchart. 

The second disadvantage stems from the artistic nature of the drawing which can be difficult for some 
programmers. Drawing software (i.e. MS Visio) goes a long way towards eliminating this problem but if one is left 
with a ruler and pencil the assembling of the chart takes some practice. Until one gets the hang of it flowcharts 
may require going through a few pencils and erasers. 

A final disadvantage of flowcharts maybe the difficulty in translating flowcharting logic into programming language 
statements. Pseudo code looks much more like a programming language and can usually be implemented much 
faster and more efficiently than a flowchart. 



FLOW CHART EXAMPLE 
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To allow for us to compare the strengths and weaknesses of the three logic modeling tools discussed in this 
chapter, I have created a common problem so that we can create the same model with each of the three tools. 

This logic path will be a simple one. Logic paths in full programs are much more complicated than what we will try 
to accomplish in chapter two. We need to start slowly to help retain the information learned. 

• The Problem: The organization you work for is in need of a tool that will calculate the cost of a product 
purchased with a foreign currency. 

• The Requirements: The Sales Department of your organization has customers from Canada and Mexico. 
Your catalogs on the web site express all prices in U.S. dollars. It has been decided that the easiest way to 
provide support for foreign customers is to create a program that will accept as input the price of the 
product and the currency factor necessary for the customer to convert dollars into their currency. For 
example, if the Canadian customer purchases a skateboard for $50.00, that $50.00 would need to be 
multiplied by a factor of approximately 1.2 to convert dollars to Canadian dollars. In this case, the 
customer will need to pay $60 Canadian dollars for the item that costs $50 dollars US. 

• Symbol A - represents the terminator simple which is used to indicate the start of the logic model. 

• Symbol B - represents a parallelogram which is used for input/output operations and in this case to 
capture information about the Amount of the item form the keyboard. 

• Symbols C - represents another parallelogram which is used this time to input the conversion factor used 
to converts dollars into the currency of the customer. 

• Symbol D - here we have a rectangle which is used to document the calculation step which will take 
amounts and multiply that times the currency factor 

• Symbol E - here we use a parallelogram again this time to display output the screen in the form of 
reported message displaying the results of the calculation done in the previous step. 

• Symbol F - Another terminator symbol, this one is used to indicate the end of the logic. 
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Start 



PrcHmpt for 
Amount 



PrcHmpi for 
ConvFactor 



AnswBf = Amojnt 
■■ ConvFacior 



Print 
Ar^swer 



End 



Figure 3: The Flow Chart Solution 



Key Concept: Both Logic models and programming languages use variables to temporary hold text and numbers 
that are manipulated by the logic statements. Variables are given names to make them easy to reference in the 
logic model or computer program. The term amount in item B in figure 3 is an example of a variable. 



Logic Tip: We will discuss naming conventions in the next chapter but both flow chart and pseudo code models use 
variables to store and retrieve values used in the model. You will want to choose a variable name that is short to 
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make it easy to type but long enough so that it is descriptive and accurately describes the value. Since many times, 
one word cannot describe the value held by the variable, you can use "camel casing" to define variables. This is 
done by joining the words that make up the variable but the first character in each joined word is capitalized (i.e. 
AnnualTotalCost or also AnnualTotCost). 



Status Check 

What is meant when we say a model is a best case solution? 
What is the relationship between a model and program? 
What are the benefits and weaknesses of flowcharts? 
Name some flow charting rules? 



USING PSEUDO CODE 

We have already touched on pseudo code in this and in the previous chapter. Pseudo code is nonstandard English 
like a programming language. It is English like because the logic statements read more like English sentences and 
phrases than what is typically found with programming language syntax. Program language statements and 
connecting syntax is much more cryptic and can take on the appearance of a mathematical equation. If you 
remember correctly from the previous chapter, I compared pseudo code to a recipe you might use to make 
chocolate chip cookies. Pseudo code is nonstandard because unlike programming languages which have very strict 
rules regarding keywords and syntax, there are no standards when it comes to pseudo code. As long as the 
statement is readable and defines what that logic step needs to accomplish, it is acceptable as pseudo code. 



Keywords: Programming statements contain keywords. The keywords are typically verbs identified in that 
programming language to perform an operation. The keyword might be a verb print or input. Each language has its 
own set of keywords but it is not unusual for some keywords to exist throughout multiple languages. The if 
keyword is almost universal in all programming languages and allows us to program decisions into our logic. 



Pseudo Code Rules: 

• The pseudo code program should begin with the Start instruction and complete with the End instruction. 

• Each pseudo code statement should contain at least one instruction. 

• Each pseudo code statement should contain a verb that represents the action performed along with any 
identifier and operators that hold program values or perform calculations. 

THE ADVANTAGES OF PSEUDO CODE 

The primary advantage of pseudo code comes from the fact that it is a programming language. It's a very simple 
and unstructured programming language and it is very easy to transition pseudo code to a programming language. 
Since we want our models to represent the best of all possible solutions, pseudo code probably requires the least 
amount of modification from model to actual program. Whereas a flowchart may represent a perfect world 
solution it might not be easily implemented into a program. Pseudo code can be more easily transitioned so it is 
more likely that our model logic will be very close to the implemented program. 
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Another advantage may be in its simplicity. It may take some time for a programmer to learn a new programming 
language but since pseudo code is so familiar and similar to reading instructions (i.e. recipe), it does not involve a 
steep learning curve. If you can read and write you can create pseudo code and understand pseudo code 
instructions. 

THE DISADVANTAGES OF PSEUDO CODE 

The disadvantages of pseudo code may start with its lack of standards. One person's logic instructions may not 
seem as logical as the next. Given the unstructured nature of pseudo code, it is few rules and is hard to 
standardize. One programmer might not see the logic written by someone else. 

Another disadvantage over other modeling tools like flowcharts may be pseudo codes inability to show logic flows 
or the bigger picture. Whereas flowcharts provide an overview of logic and can be understood at a higher level, 
pseudo code is far more detail oriented and requires more concentration and practice to see the bigger picture. 
Put another way, pseudo code focuses more on the details and the graphics of flowcharts allow for a 10,000 foot 
big picture perspective. 



PSEUDO CODE EXAMPLE 

Using the problem and requirements from the flowchart section of the chapter we now put together a pseudo 
code representation of the logic design. 



In Practice: Pseudo Code is Recyclable - Using Pseudo Code for Program Comments - Even when students 
understand the importance of creating logic models they are reluctant to use pseudo code because they're not 
sure that it adds value to their programming. Most would tell you that pseudo code slows them down and in their 
impatience; they will start their programming without it. But there is a way to recycle your pseudo code from your 
logic model into your program design and get more out of your pseudo code. Pseudo code is very similar to 
program comments. A program comment is a non-executable statement that is inserted into a program to give the 
programmer information about how the program is constructed. It is very specialized documentation left for the 
next programmer to clarify the programs design. There's no reason why the pseudo code could not be the basis of 
your source code comments. As you develop your program and implement the pseudo code into language 
statements, why not copy the pseudo code down into the program and use the pseudo code as the comment. In 
PYTHON for example, you could take the pseudo code and place a # sign in front of each pseudo code statement so 
it now becomes a program comment. This way you'll be able to recycle your pseudo code back into the program 
and it may not longer seem like a wasted step. 



Status Check 

What are the benefits and weaknesses of pseudo code? 
Name some pseudo code rules? 

It is said that pseudo code is more "English" like. What does this mean? 
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VERIFYING YOUR PROGRAM LOGIC WITH PYTHON 



This eBook has often referred to the advantage of using PYTHON as a replacement for pseudo code as a modeling 
language. It should be acl<nowledged, that PYTHON as a replacement for pseudo code works best in a learning 
environment. For this reason, as a employed programmer, your Supervisor might look at you a little funny if you 
proclaimed you w/ere going to model the application in PYTHON first. The benefit to an organization modeling logic 
with PYTHON may be limited and likely to be more expensive. 



Background Information: The History of PYTHON - PYTHON was created by Guido Van Rossum in 1990. It was 
designed to be an easy to use scripting language run from an interpreter. The language has been freely available 
since its inception. It is an open source product that accepts contributions of code from a community of 
programmers. It is the contributions of these programmers that continue to improve PYTHON and enable new 
functions. The name PYTHON was selected by its creator in honor of a group of comedians called Monday Python's 
Flying Circus. If you thought the name came from the snake you're wrong. If you're old enough, you might 
remember the television program called Monty Python's Flying Circus. The program was popular in the late 
seventies and from the many movies created by Monty Python's Flying Circus (i.e. Monty Python and The Holy 
Grail"). If you have seen one of their movies or watched the television show, then you can appreciate the irony and 
comedy in the name. 



PSEUDO CODE EXAMPLE 

Using the problem and requirements from the flowchart section of the chapter we now put together a pseudo 
code representation of the logic design. 

#Gary Marrer 
#PYTHON example 
#Start Program 

Amount = input("Enter Amount" 
ConvRate = input("Enter Conversion Rate") 
Amount = Amount * ConvRate 
print Amount 
#End of Program 



TIP-The PYTHON programming language was developed as an open source product that has a very active user 
community. There are many PYTHON programmers that have developing free sample PYTHON programs, PYTHON 
documentation. As mentioned earlier, many programmers have contributed enhancements to PYTHON. One of the 
best PYTHON resources is the PYTHON web site. Check out www.python.org for a lot of very valuable PYTHON 
information. 



PYTHON - FLOW CHARTS - PSEUDO CODE COMPARED 
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There is no best tool when it comes to modeling. One would argue that if you are working with people that had no 
it programming or logic design experience, a flowchart would probably be the most successful approach since it is 
graphical. Most people typically visualize ideas and concepts more easily than understanding them from text. 
There's a lot to be said about the adage "a picture is worth a thousand words." When working with end users, this 
is definitely the case and the reason that flowcharts are a good first choice or starting point. 

It has been my experience, that if the programmer is not required to use one specific model (in some cases and 
organization may standardize on a model so that is consistent across the organization making it easier for 
everyone), the programmer will gravitate towards one or more of the models in preparing his logic. 

What works best for me is flowcharting for high level views of logic that identify key modules and the program 
(modularization is covered in chapter four) and pseudo code to document logic within the module. Another 
programmer may only use flowcharts and another still might favor pseudo code. As you use the models available, 
you will develop a preference that works the best for you. 



TIP: another term used in place of logic model is program specification. The program specification can be done by 
the programmer or by a systems analyst. No matter who creates the specification it will contain a blueprint of the 
logic needed to be developed to solve the problem. The specification will usually be a series of flowcharts or 
pseudo code. 



SUMMARY OF PYTHON BENEFITS FOR WRITING PROGRAM LOGIC AND PROGRAMS 
*PYTHON is very similar to pseudo code 

*Can be used as a modeling language or programming language for new programmers to get exposure to creating 
and logic and programming 

*Since PYTHON allows you to both model logic and program in one environment, it can provide the new 
programmer to one environment for learning all phases of the program development process 

*PYTHON supports structured, object oriented and event driven programming environments 

*PYTHON provides an easy way to validate model logic 



PYTHON Tip: PYTHON greatest benefit is to the new programming student because it provides the ability to test 
the program logic you have created before you code the programming language statements. 



PYTHON: PYTHON is an easy to use interpreted programming language that provides an excellent opportunity to 
learn logic and programming. It is also a popular programming language used by many programmers and because 
it is an open source program, it continually as improved and more and more resources are available for PYTHON. 
You can visit the PYTHON web site at www.python.org to see some of the newest PYTHON enhancements. 



One of the problems assigning new programmers modeling problems is that many times the assignments look very 
good. They look ninety percent good, without having the benefit of a lot of modeling experience Or the ability to 
anticipate logic paths based on previous programming experience many new programmers fall short of correct 
solutions. This is where PYTHON does its magic. Since PYTHON and pseudo code are so similar, pseudo code can be 
converted to PYTHON and with a couple of print statements, a solution can be validated. That is to say that if you 
know the answer to logic problem then you should be able to prove that loci solution with a PYTHON program. No 
longer is the logic model almost correct. The solution model can now be verified and validated with PYTHON. 
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Key Concept: it is important to keep in perspective that both pseudo code and flow charts are language 
independent. This means that when you model logic with these tools you are not required to implement the 
solution in a particular programming language. These tools work with all languages and it is just a matter of taking 
the model and converting it to the computer programming languages keywords and syntax to implement the 
program. 
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Flowchart 



start 

Input WSCost 
Wari<up equals 1 .25 
Handling equals 5 
CuslCost equals WSCost times 
Markup plus Handling 
Print CuslCost 



Pseudo Code 



End 



#Gary Mairer 
#PYTHON example 

#Start Program 

Amount = inpiit("Enter Amount 
") 

ConvRate= input("Enter 
Conversion Rate ") 
Amount = Amount * ConvRate 
print Amount 
SEnd of Program 



PYTHON 
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Figure 4: A modeling progression from flowchart to program with pseudo code in between. The progress of 
flowchart to pseudo code to PYTHON represents a consistent methodology for modeling a problem solution. 



INTRODUCTION TO PROGRAMMING TOOLS 

All new programming languages, along with those programming languages which still remain vital today, include a 
set of tools to make the programmer of the language more productive. As has been mentioned earlier, software 
logic design still remains a very labor intensive process. The more help and assistance that can be given to the 
programmer to create his software efficiently and effectively is an added bonus for that programming language. 

IDE - INTEGRATED DEVELOPMENT ENVIRONMENT EXPLAINED 

Most modern programming languages have one or more Integrated Development Environments available for 
program development. Some languages like Java might have ten to fifteen different IDE's that can be used for 
developing Java programs. Each IDE may have been developed with a particular strength or purpose. One IDE 
might have a more graphical focus and another IDE might be designed to work with several different languages. 
IDE's can be a lot like automobiles. Even though automobiles function mostly to provide transportation, there are 
certainly a number of options to look at when it comes to deciding the automobile best for you (Mini-Van versus 
Convertible). 

If we were to look at the program development process discussed earlier the chapter, we can relate how the 
integrated development environment makes the programmer more productive. 



1. 


Start with a problem statement: 


2. 


Fact finding or requirements analysis 


3. 


A conceptual design 


4. 


A detail design 


5. 


Testing 


6. 


Implementation 


7. 


Maintenance 



IDE's begin to show their real benefits after conceptual design. However, many IDE's provide for task management 
via task lists embedded within the IDE itself. This one allow for the programmer to identify the key components of 
his programming logic as a task and then implement them in code and checking them off the task list as that code 
is developed and tested. 

Where the IDE is most beneficial is in code development and test. Once the conceptual design is complete in detail 
design begins, the IDE provides the source code editing and syntax checking. Many of the IDE's today will check 
syntax as the source code is being entered. This cuts the time of development by eliminating periodic compiles to 
locate syntax errors. 
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Visual Studio.net is one of the most popular and comprehensive IDE's. Perfected by Microsoft over several new 
releases of Visual Studio, it contains not only a editor, compiler and debugger but also features such as code 
complete, code regions and statement color highlighting. 

Once the source code has been completed in the editor, it can be tested via built-in interpreters or built-in runtime 
environments. This allows the programmer to run the program without leaving the IDE where additional editing 
may need to take place. Most IDE's also contain source code logic debuggers. The debugger is a program within 
the IDE that executes each line of code step by step allowing the programmer to investigate the contents of 
variables along the way. 



TIP: Get to know the debugger used in the IDE. Not only does the debugger show the flow of statements but also 
allows you to see the result of each statement. This is a handy way to learn what each statement does within the 
program. 



This is a specially valuable and discovering logic errors where the program has valid syntax and runs without error 
but has within it a logic error preventing it from calculating the correct answer or taking the correct option. This is 
especially dangerous because the program seems to be running fine but in fact has a serious error that leads to a 
misleading solution. 



Program Debugger: You might want to look on your debugger as your personal professional guide. The debugger 
will guide you through your program and show you the sequence the statements are executed and the effect of 
the statements on program variables and logic. 



Built-in to most IDE's is also extensive online help. This help can either be searched by keyword or can be hot 
keyed by marking a statement with a mouse and hitting a function key to activate help on that selected keyword. 

Status Check 

What are the main components of a IDE (Integrated Development Environment)? 
What is the purpose of a debugger" 
How is PYTHON similar to pseudo code? 



THE SCENARIO - CACTUS BOOKS AND TAPES 

You have enjoyed your time spent a Cactus Books and Tapes so far and you want to continue to set forth a good 
impression. Christina and Lois Chavez have been very helpful in supplying you with information about how the 
Internet book reservations system will need to work if the project is to be successful. They understand the process 
from a manual standpoint but they are computer novices so they are dependent on you to create the automated 
solution. Since they're still getting comfortable with putting part of their business on the Internet and also 
evaluating your abilities to create a workable solution, you have decided to model one of the more complicated 
aspects of the book reservation program. This will be a good way to get their confidence. 

Since they want the ordering system to be competitive with the larger booksellers, they would like the book cost 
to be quoted at the time of reservation so that when the customer orders they will get the best price. This price 
will be a 25% markup over the current wholesale cost plus a $5.00 dollar handling fee. You have suggested a dry 
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run of this algorithm and you will show them a flowchart and pseudo code program that will calculate the correct a 
price based on test data. 



TIP: Computer users can be your biggest ally or biggest problem. They can embrace your project, they can reject it 
or worse they can sabotage it. Make sure always include the user in the design of the program. This promotes buy- 
in and will ensure that if there are any bumps in the road as you turn the program over to production, they will be 
your partner and deal with problems in a fair and friendly manner. If not, your life as a programmer will be 
infinitely more challenging. 



(1) ldentifying the Problem 

A computer program needs to be created that will calculate the cost of reserved book. 

(2) The Requirements 

The calculation used to price a reserved book is a wholesale cost times a 25% markup plus a $5.00 handling fee. 
The calculation can be formatted as follows; 
CustCost = WSCost * 1.25 + 5 

Note: WSCost is the variable that stores the wholesale cost value and CustCost is the variable that stores the 
customer cost. 

WSCost needs to be captured from the customer. This will be keyboard input. A twenty five percent markup would 
be accomplished by multiplying the amount times 1.25 so the entire cost is captured plus twenty five percent 
more. 

(3) Plannlng Logic 

First we would create our flowchart with start and end symbols. In between, we have a Read/Write symbol to 
capture wholesale cost followed by sequence symbols for setting the markup and handling cost. Next is the 
calculation of Customer Cost and finally a read/write symbol to print the solution. Our flowchart has been created 
in figure 5. 
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Figure 5: Solution Flowchart 



We can extract our pseudo code from the flowchart by looking at the labels and fine tuning these labels into 
English instructions. Our pseudo code will look like this. 

Start 

Input WSCost 
Markup equals 1.25 
Handling equals 5 

-CustCost equals WSCost times Markup plus Handling 
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Print -CustCost 
End 



In Practice: What is happening in the computer? - It should be noted that at this part of the programming process 
your source code statements are being interpreted line by line and converted into machine code instructions for 
the processor and memory to act on. Statements which started out looking very English-like have converted and 
converted it to binary codes which the microprocessor can quickly act on and if required place data values to 
memory locations for data manipulation. Once one statement is executed the interpreter moves to the next. 



DEBUGGING PROGRAM ERRORS 



Fixing programming errors for any programming language involve essentially the same process. If the error is a 
syntax error, you'll need to return to that line in your program and determine what part of the statement is invalid. 
You'll need to correct that statement before you can execute the program again. 

If the program runs without syntax errors but does not give you the correct answer, then the program must have a 
logic error. Logic errors are the most difficult errors to resolve. The PYTHON interpreter is not going to be much 
help here. As far as the interpreter is concerned, the code is correct and can be executed successfully. To find logic 
errors you'll need to load a PYTHON debugger program (not something we will tackle at this point in the text book) 
or you'll need to return to your source code and analyze line by line what each statement is asking the operating 
system to do. This is a skill that develops over time in unfortunately as your programming gets stronger so does 
your debugging skills. But that's the paradox. As you become a better programmer are you are probably in less 
need of the debugging skills which you've now developed to an expert level. Life is filled with ironies isn't it? 



Logic Errors: logic errors can be the most difficult type of programming errors to solve. With syntax errors and 
runtime errors the system helps resolve the problem by giving us an error message that usually points the source 
of the problem. When the logic error, the program operates and completes successfully. There may be nothing in 
the operation of the program that looks out of the ordinary. This is why the testing of your program is so 
important. You need to validate all calculations especially. Just because the computer program says salary in 
equals $1,000.00 dollars, it does not mean the calculation is correct. The program logic may have asked to divide 
when it should have added two values. Testing is a very important part of being a successful programmer. We will 
discuss testing in the "Putting it to Practice" Section of this chapter. 



Remember, there is also a third error type that we discussed earlier called a logic error. This type of error returns 
no error message from the interpreter but has a logic error which is preventing the program from determining the 
correct solution.. 



Exceptions: Exceptions are runtime errors. Before you can get a runtime error, you must be free of syntax errors. 
Runtime errors occur during program execution and are caused when the program is in a state that it is unavailable 
to reconcile. For example, if your program accepts two numbers as input and uses the second number to divide 
into the first number, then a runtime error will occur if that second number is zero. Since divide by zero is an illegal 
operation, the program is unable to continue. We will revisit exceptions in upcoming chapters as we introduce new 
logic structures and programs. 



Status Check 

Give an example of a syntax error, runt time error and logic error? 



Program Development with Logic ModelingTools | http://laptoppress.garymarrer.com 



Copyrlgfilct) malanai 



What is the function of the PTYHON Interpreter? 
What is a PTYHON script and what are its benefits? 



TESTING THE PROGRAM FOR ACCURACY 

As a programmer; you'll spend a lot of time during the design and coding phase of your programs testing first the 
logic and then the program. Just like learning how to program and creating logic models Is an acquired skill, testing 
Is also a skill that needs to be developed. One of the basic testing pitfalls for most programmers Is only testing the 
correct operation of their program. They forget that as the programs designer, they have a complete 
understanding of what the program must do and how will work. To test the program, you need to step back from 
normal operation and try to think of those scenarios that the typical user might try to do with your software. For 
example, you may need to test your program so that it can correctly handle an error caused from a user inputting a 
letter In a field that must be a number. You may need to test your program so that If the user keys In a negative 
number when only a positive number will work, an error message will be displayed and an option to correct the 
number In error. There are literally tens of options to be test. Take a moment and think about the tests you might 
have to provide to validate a zip code entered Into your program? 

Some possibilities: 



1. Must be numeric 

2. Must be five numbers only 

3. Must be five number characters because zip codes are not calculated 

4. Must not be negative 

5. Valid zip codes Issued to municipalities 

6. Anything else we have missed? 



PUTTING IT TO USE 



The Intent of this section Is to introduce the new programmer to standards and techniques frequently used by 
professional programmers. Topics in this section relate to concepts Introduced In the chapter but with a more 
vocational or occupational focus for students considering a career In programming. 

BEST PRACTICES: CREATING TEST DATA TO TEST YOUR LOGIC AND PROGRAMS 

As the programmer, one of your responsibilities Is to test the logic and programs to make sure the program will not 
only work correctly but also recover gracefully from bad data or keyboard Inputs. When I say recover gracefully I 
am talking about the display of a meaningful error message and the ability for the user to correct his Invalid Input 
and continue with the program. You must be able to anticipate the problems before they happen even If you know 
the program Is not supposed to be used the way It was. To do this you must be creative. You need to not only 
simulate typical transaction and also simulate those transactions that fall outside of acceptable parameters. 
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There are two categories of tests you need to be concerned with at this time. The fall under the category of 
program input and can be broken down into two sub-categories. One sub-category is data file input and the other 
sub-category is keyboard input. Data files tests include ensure the loading the program with valid and invalid data 
files (or databases). The program must ensure that data is loaded into the program correctly and that invalid data 
files are flagged as bad and the user has the opportunity to correct the error. For example, if the files you program 
are processing are text files with a file extension of .txt and the user tries to load data from a file with a .exe 
extension, the program will see the binary characters in the .exe file and cause the program to error. Correct 
processing should have a message pop up and a file browse dialog box appear for the user to select another file. 
You know that the program needs a text file but you cannot expect the user to know the same. 

For keyboard testing, you need to do the same validation with error messages and corrective alternatives for the 
user. A typical keyboard test might be checking to make sure that a textbox that is expecting required numeric 
data for a calculation recovers when either the required field is left blank or if a letter was inputted instead of a 
numbers. 

We will cover some of the standard validations checks such as required field, numeric field, and range checking 
along with some more specialized tests later in the eBook. For now you need to be creative in logic design to 
include tests that will make the program robust in the face of users you may input the totally unexpected into your 
program. 



Related Subject: A typical user - No such thing. When you think about testing your program, it's natural to test the 
correct sequence of operations needed for the program to complete successfully. As a programmer, this is the 
most obvious and because of your experience developing a program it is the sequence that makes the most sense 
to you. The people using your program don't have the benefit of that experience or knowledge. Because of this, 
you need to be creative in determining what is possible in terms of input non-program control from your user. 
There are all kinds of interesting stories from some of the larger PC companies or users have called in with a rather 
our readers' questions. One of my favorites is the customer who called in to think the PC manufacturer for 
including a coffee cup holder with their new PC. When asked about such an accessory and how to operated, the 
user explained that by hitting the small button to the bottom right of the coffee cup holder, it slid open from the 
PC. What was one person's coffee cup holder is another person's CD-ROM drive. It's funny but this is exactly the 
kind of scenarios you must be aware of as you test your product for potential user errors. 

The best approach to ensure that all tests are included in the logic is to develop a test plan. This is done early in the 
process even before the models are constructed. It is difficult to think of all of tests up front but give it your best 
try and then add to the test plan as you come up with new tests. 



Test Items 


Scenarlol 


Scenario2 


Scenarios 


Scenarlo4 


Scenarios 


Scenarios 


Zip Code Field 
Validation 


Must be 
numeric 


Must be five 
numbers only 


Must be five number 
characters because zip 
codes are not calculated 


Valid zip 
codes issued 


Anything else 
we have 
missed? 


Must not be 
negative 



Table 1: Test Plan Zip Code Field Validation 



Putting It to Use | http://laptoppress.garymarrer.com 



Copyrlgfilct) malenal 



A good test plan is typically identified as a decision table or matrix where the test items are listed as rows and the 
possible outcomes listed as columns (see Table 1). As you run through these different scenarios, you'll check each 
intersection of row and column to ensure that you've tested that outcome. The same matrix will come in handy 
later on if changes are made to the program and you have to do what's called a regression test. A regression test is 
done whenever the program is changed. It's called the regression test because all of the original tests are 
performed one more time to ensure that the outcomes are the same. It's all too common that fixes to programs 
create new errors. A regression test helps to prevent this. 

Test Plan: As has been true with so much of what we have learned about so far, the testing your application should 
be a systematic process that ensures the testing is done with the same accuracy each time it's performed (i.e. a 
new program and an updated program). One of the ways to ensure that the testing is complete is to document a 
test plan that acts as a decision table to isolate all of the possible outcomes the program could experience. For 
each of these outcomes, your program must either have an error message and preferably an error message with 
corrective action done under the direction of your program logic. You cannot assume that your program is going to 
be used exactly in the manner in which it was designed. You must account for all of the possible ways the program 
can be executed. 



Regression Tests: I can remember one company I worked for who calculated that for every two errors they fixed 
they developed a new error. Programs can be very complicated and some programs are very large which only 
increases the chance for more errors. It's not unreasonable to believe that in repairing one problem another 
problem might occur as a result of the original repair. One way to ensure that program changes don't negatively 
impact the initial program functions is to create a series of basic tests that would verify that the base functions of 
the program have not been damaged. This regression test would run through the series of tests every time the 
program was changed. If the regression and test plan is documented up front, then even a change occurs years 
after the original program was created can be tested again for the same basics functions and features without 
having to rely on a programmer's memory (...not a good thing). 



Related Subject: Learn from other Programmers - Copying code? It is okay, really and yes, it is fairly common that 
programmers will copy code from other programmers to develop their applications. In fact, this is fundamentally 
what happens when we talk about code reuse (code reuse is a very good thing). This is not to suggest that you 
should use copyrighted program code but you need to understand that there's a lot of code in the public domain 
which is generic enough so that it might be useful as a starting point for your program. It makes little sense to 
reinvent the wheel" when a solution already exists. It may not be exactly what you want but if even if half of it is 
useful, it will save you time for other activities on your program. For example, let's say you need a program to 
calculate the number of weekend days between some span of dates. You could write this for yourself or you might 
look for free code Java, C# or Visual Basic web site to see if someone has already come up with something similar. 
Chances are you will have to make a change or two to it but it makes a lot of sense to take advantage of what has 
been done. You want to avoid just a blind copy. Look over the code and understand how it works. In addition, just 
because it is free doesn't mean it is any good. It may be designed in a way to slow program performance or maybe 
there is a security exposure, so you want to give it a good once over before to use it. 
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Chapter summary, highlights, l<ey terms, short answer questions, quizzes and case studies to reinforce topics 
covered in this chapter. 

CHAPTER SUMMARY 

• Explain why it is important to use logic modeling tools when designing a software program. 

o Good programming discipline mandates that programmers and should model of their logic 
before coding their programs. Logic models act like builders blueprints to ensure that all the 
problem requirements are included in the solution. 

• Describe the advantages and disadvantages of using flow charting and pseudo-code to design a program. 

o Programmers use flowcharts to create graphical interpretations of logic and we pseudo code to 
create English-like statements to represent logic. 

• Recognize the components of a test plan and the benefits of developing and following a test plan. 

o A good Test Plan would document all anticipated data or user errors encountered by the 
program. 

CHAPTER KEY TERMS 

Automated Process 

Exception 

File Extension 

Eile Name 

Elow Chart Symbols 

IDLE 

Keywords 
Logic Error 
Logic Paths 
Manual Process 
Model 1 
PYTHON 
Regression Test 
Script 

Syntax Error 
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PART 1 INTRODUCTION PROGRAMMING 



CHAPTER 3 FUNDAMENTALS OF PROGRAM DEVELOPMENT 



IN THIS CHAPTER, YOU WILL LEARN HOW TO: 



• Explain the processes used to create programs 

• Developing programs from program logic 

• Define and explain the use of identifiers in computer program 

• Describe and demonstrate identifier data typing and scope 

• Explain and differentiate between expressions, statements, code blocks 

• Describe and demonstrate how arithmetic operators are used in expressions 

• Explain and classify syntax, Run-Time and logic programming errors 



THE PROCESS OF CREATING PROGRAMS 



In our previous chapters, we have spent a great deal of our time introducing programming as a series of processes. 
The use of processes has been a technique used in quality control to ensure that tasks are performed the same 
way each time. Although this may sound a little boring and monotonous at first glance, if we develop programs in a 
consistent and standardized fashion, we will minimize known defects and also have a systematic way of preventing 
new defects from occurring again. 

You might think of a process as a checklist. The checklist has identified in the correct sequence a list of tasks which 
must be performed for the process to be completed successfully. A checklist is not that much different than the 
recipe analogy we used in chapter one to describe how a computer program sends instructions to the operating 
system. The difference is that a checklist provides a more general and generic list of tasks whereas the recipe 
contains specific instructions. Again, we do not want to make programming a mechanical and inflexible activity but 
we are working with machines. These machines called computers have very strict rules that govern how they are 
controlled. 
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One of the less obvious benefits associated with using processes is that a process can also be a standard. Standards 
are important to information systems because just as a personal computer has many devices which must 
communicate via a standard (the operating system), most programs are maintained by several programmers. 
When a programmer works on someone else's program, if that program has been developed with industry 
standards, then the chances that the another programmer will be able to modify the initial program without 
problem is very likely. Just as the electrician provides wiring to your house to industry standards, so that other 
electricians can later on modify the wiring in your house, programmers that follow process standards make it much 
easier for different programmers to perform program maintenance later on. 

So far this eBook we've introduced two different processes. The first process was SDLC or System Development 
Life cycle. This process was an umbrella process used by systems personnel to create and maintain systems. This 
process serves as a template for a second process which was called the Program Development Process or PDP. The 
program development process reinforced our plan to use logic modeling and programming structures to create 
computer programming solutions. 

We will start this chapter with a short review of the program development process first defined in chapter one. 
Once this process has been reviewed, we will cover a variety of topics related to programming and specifically to 
PYTHON. As part of the programming discussion, we will also include some limited discussion of Visual ~Basic.NET 
and Java, since both of these programming languages are popular in entry level programming classes. 

BACKGROUND INFORMATION: CURRENT TRENDS IN PROGRAMMING 

Programming languages and field of programming has not changed a great deal since the seventies. This is 
especially obvious when we look at the amount of change compared with computer hardware over the same 
period of time. While we have many more programming languages today, most are still designed primarily around 
structured programming techniques ( the topic we will cover in chapter four) with many programming languages 
now also supporting object orientated programming techniques ( a topic we will cover in later chapters). 
Historically, most of the innovation that appears in programming is represented by the tools that have been 
developed to make the programmer more productive. For the newer programming languages, these tools have 
been bundled within an increasingly more sophisticated IDE. Whereas debugging logic errors in the past included a 
line by line review of program source code, there are now built-in debuggers which assist the programmer by 
automatically walking through the code with the added ability to also graphically inspect the contents of the 
identifiers and objects as the program is executed. 

Other enhancements have included more sophisticated interactive help search, built-in project task support to 
allow the programmer to track their status in the programming process, code formatting tools which allow the 
programmer to code more quickly and still reduce syntax errors. Program statement coloring and automatic and 
indenting of program blocks also help the programmer create source code that is easier to read. 

Some IDE's also support real-time compilation (Note: most of the time compilation is a separate step done after 
program coding is complete) so that the program is compiled as it is entered into the source editor. This notifies 
the programmer immediately of syntax errors. Two programming products which have been seen as leading the 
pack and programming productivity and functionality are Microsoft's Visual ~Studio.NET (in which Visual 
~Basic.NET is a part of) and Java. It is early for us to cover some of these features, but as we move through the 
eBook many of these programming improvements will be covered as topics. 



A REVIEW OF PDP (PROGRAM DEVELOPMENT PROCESS) 
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The process we use as programmers to create and maintain computer programs is the program development 
process. If you follow the process and use its major steps, it acts as a checklist that will greatly improve your 
chances for success. The process was built by programmers who came before you and reflects steps that have 
historically made other programmers successful. 

You cannot underestimate the common sense behind this process. Being based on common sense steps is an 
advantage, since it should make the process more intuitive and easier to implement. After all, can you think of a 
different problem solving process that could universally be so effective? You might find other textbooks and other 
programmers using programming development processes with different names or slightly different approaches but 
they all will include the same steps as PDP behind the scenes. 

What you'll also find is that each of these processes is fundamentally built from the problems solving techniques 
reflected in the system development lifecycle. I've had many students tell me that this process is no more than the 
scientific method taught in so many other science classes. I've had management students tell me this process is 
nothing more than problem management. In all cases, the approach is logical and something which everyone can 
relate to as a process for solving problems. In other words, it is a common sense approach to solving any type of 
problem whether it is a computer program written by a programmer or an investigation into a drop in profits by an 
accountant. 



In Practice: Making Programming Mistakes - I've seen many programmers (both novice and experienced) be 
unduly harsh on themselves when their programs have errors. On more than one occasion a programmer has 
resolved an error only to classify it as a "stupid error." Programmers may work on machines but they are not 
machines and will make errors. In addition, programming is not a spectator sport. Technology changes incredibly 
fast and to expect that knowledge today will be just as appropriate years from now is naive. Programmers need to 
experiment and try new techniques. When you experiment you'll make mistakes. I've always told my programmers 
that making a mistake is no sin but as a professional programmer you should strive to not make the same mistake 
twice. Sticking to the processes that have evolved from other programmers is a good way to minimize your errors. 
Doing a root cause analysis or investigation as to why a program fails is a good way to prevent that error from 
happening again. The worst thing that can happen from an error is to not learn from it. 



PROGRAM DEVELOPMENT PROCESS (PDP) REVISITED 



• Planning Stage: It is critical that you define a problem statement which completely documents what the 
programming project will involve. Although scope creep is more commonly associated with system design 
and not individual programs, make sure that you include exactly what the problem will involve. Beware of 
letting outside forces (users, stakeholders, management, other programmers) change the problem into 
different requirements that over time will change the original program into something different. Do not 
let the scope of the problem change so that it transforms your original design/requirements into a 
program that no one is happy with. 

• Fact finding or requirements analysis is the detective work necessary to extract from the end users of your 
program the programs requirements. You may need to see the paper documents currently used to 
develop your specifications and you will want to interview the end user to determine all the important 
features of the program. You need to probe the user since what you may have to have in your program 
design maybe a consideration lost by the end user as insignificant. Many end users will not have the same 
appreciation of what is required for the program and may have misconceptions of what computers are 
capable of accomplishing. You may need to coach them through the requirements. 
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• At this stage of the eBook, we have completed the topics on conceptual design. Our projects should have 
pseudo code or a flowchart identifying the ideal logic structures to provide a solution. Conceptual design 
is your starting point. This design may change when implemented in the program. Programming 
languages have a different set of rules than logic models that have to be accommodated. For example, 
variable scoping rules (which are discussed later in this chapter) is an example of changes made in the 
logic model to accommodate the program. 

• In this chapter, we take our first steps at coding our logic solution using a programming language. For us, 
we will be programming with PYTHON but I have also included samples of Visual '"Basic. Net and Java in 
the examples to give you an idea of what some other programming options might look like. We take the 
conceptual design as a starting point and using the syntax options of the programming language, code the 
logic structures into programming language statements. At the end of this stage, we have completed our 
physical design or how the logic will be implemented with a programming language. 

• We discussed testing for the first time in the last chapter. When the program is first created, unit testing 
is performed on just sections of the program. We need to start small and work up. For example, if a 
program has several complicated calculations, we will want to test each calculation after they are coded 
instead of waiting until the entire program is complete. It is much harder to isolate program code 
problems when you start from the entire program. It is must easier to test in smaller increments and 
much more effective in developing a comprehensive test strategy. Any unit tests will be added to the test 
plan so that future program changes can be retested. 

• During implementation, we move our program into production. The program is complete, tested and 
ready to use. 

• Maintenance is an on-going process. No program is written once and not revisited with some changes at 
some later time. Maintenance usually starts immediately with some unforeseen item missing from the 
program or perhaps some customization to accommodate better performance. There a number of 
reasons why programs will need to be maintained. 



Key Concept: With SDLC and PDP we always start with a problem statement. Sometimes programs are created not 
for problems but for opportunities or mandates. The problem statement has been used as a generic term to 
describe reasons for creating programs. Sometimes programs are created because it offers a new or unrealized 
benefit to an organization. Sometimes programs are created by mandate. Either a regulatory concern or perhaps 
even a company merger may require new software to be developed even if the software has no problems and 
offers no real benefit over the existing program. It is important to remember that creating programs is not always 
related to solving some negative consequence. 



DEVELOPING PROGRAMS FROM PROGRAM LOGIC 

In chapter two, we spent the bulk of the chapter in a discussion of logic and the importance of logic in creating our 
programs. It is now time to take the theory and apply it in the creation of some programs which can put some of 
our logic in action. The main goal of our programming in this eBook is to validate logic and not necessary creating 
applications. However, any exposure to real programming can only help our understanding of the program 
process. For the most part, the topics we will cover in chapter three are generic to all programming languages. 
Occasionally, a programming language may use a term slightly different than one discussed in this eBook. When 
possible I will try to give you a cross section of terms that would cover the more popular and more prevalent 
programming languages. We will also identify key words and syntax which are specific to PYTHON. We will need to 
discuss PYTHON programming in some detail so that structured in object orientated programming techniques can 
be created and validated with PYTHON. PYHTON details will be identified as PYTHON Tips sections in the eBook. 
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IDENTIFIERS: VARIABLES AND CONSTANTS 

All languages support the creation of identifiers. These identifiers typically take the form of variables and 
constants. Identifiers allow us to create locations in computer memory that can be referenced by a name in our 
computer program. For example, our program may need to hold three pieces of numeric information. The first 
piece of information is annual sales. The second piece of information is annual cost in the final piece of information 
is annual profit. The computer stores data values into computer memory. To the operating system and the 
processor, computer memory is accessed by some valid address. Computer memory addresses are typically 
referenced by their hexadecimal locations. Using a hexadecimal number format, although very efficient for the 
operating system to use, is very cumbersome for programmers (i.e. it is easier to reference a variable named total 
then an address with a hexadecimal address of 3A2C). This is very similar to our use of URL domain names to 
access Internet web sites verses their IP addresses which consist of four numbers separated by dots. Because using 
identifier names are so much easier than remembering memory addresses, all programming languages allow for 
the creation of identifiers. 

The names for identifiers are controlled by the programming language but there are some common rules that are 
applied to most programming languages. Many languages are case sensitive which means the compiler or 
interpreter makes a distinction between two variables of the same name when letters in the name have a different 
letter case (i.e. upper case versus lower case). 



Identifiers: You can take the definition of identifier literally. The identifiers variable and constant reference 
program locations in computer memory that store values that are related to those identifiers. Variables are 
identifiers that can change during program execution versus constants that are set and cannot be changed. Rather 
than needing to remember an address in memory we can alternatively identify that address with a variable or 
constant name in use that identifier throughout our program. 



74 
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Identifiers 



Assignments 
Answer = 0 



Variable 
Answer 



A 



\r 



Can be initialized to any 
value 




Constant 
Pi 



Must be initialized and value 
can not change 



Figure l:ldentifiers 




An5wer= Answer + 1 00 



Answer=77 



] Pi = 3.14 



Defining 
Variables 



When we define an identifier we give it a name and a data type 



Initializing initializing an Identifier Involves setting its original value, For numbers this will usually be zero 

Variables and for text/strings the value Is set to null. 



Referencing 
Variables 



Referencing an Identifier Is how we retrieve the value stored In memory. 



Assigning Assigning an identifier is how we set the value in memory. This Is usually accomplished with the 
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Variables 



assignment operator which is an equal sign (=) for most languages. 



Table 1: Identifier activities 



Programming Tip: Case Sensitivity. Many programming languages are case sensitive (PYTHON is case sensitive as 
well as Java and the C family of programming languages). What this means is that an identifier spelled TOTAL is 
different from an identifier spelled total which is different than an identifier spelled ToTaL. Even though the letters 
are the same, the case the letters are different and that makes the identifiers unique. When we spell the word 
TOTAL in upper case letters it becomes different than total spelled in lower case letters. Case sensitivity errors 
typically show up when the program is compiled or interpreted. For the new programmer, these errors can be very 
confusing since you know you typed in the right variable name but forgot that a variable had letters of a different 
case thus making the variable different. 



INTRODUCING TERMINOLOGY IN THIS EBOOK 

Many times in this eBook terms may be introduced before they are fully explained. This is not unusual in computer 
manuals. Computer programming is not learned as a sequence of topics that all naturally follow each other. 
Sometimes it will seem like we are jumping around or introducing topics before they have been explained. This 
may happen but every attempt will be made to introduce as much of the topic as possible while not making it 
confusing. Sometimes it may be useful to use the index to go ahead to another chapter if you would like more 
information on a new term or concept. 

VARIABLES 

The most popular identifier is the variable. By definition, when something is variable it can change. A variable in a 
computer program has the same characteristics. A variable may start off empty or with a value of zero. In the 
course of running your program, the variable may be assigned values before the program completes. Variables are 
temporary and are created by your program and are automatically removed from memory when the program 
completes (or if the power is turned off since computer memory is volatile memory). In the case of annual profit, 
annual cost and annual sales, all three of these values could be stored these easily in a variable. 

Most computer programming languages require that variables are declared before they are used. The declaration 
of a variable assigns a name and a data type to the variable. The naming of variables is typically standardized in 
each programming language and will be discussed later in this chapter. The data type of a variable identifies the 
type of information stored. In its simplest sense, a data type can be either characters (also known as text or 
strings) or numbers. 



Variable: Taken literally, when something is variable, it is subject to change. A variable is an identifier that can hold 
different values during the execution of the program. Variables allow us to run the same program repeatedly with 
different data. One time our payroll program might run with hours = 40 and rate = 5.50 and the next time with 
hours = 50 and rate = 10.00. Hours and rate are the variables that allow us to use the same program many times 
but with each time having variable (different) data. 



Declaration: Most computer languages require that identifiers are declared before they're used in the program. 
When we declare an identifier we provide a name, a data type and for some languages the scope of the identifier. 
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Key Concept: Storing Numbers - there is actually two ways of storing numbers. The first method stores the number 
in a format that allows for the number to be used within a calculation or expression. The second format stores the 
number as text. Typically, numbers which are not used in calculations are stored as text. For example, a zip code or 
telephone number are typically represented as numbers but are not used in calculations. Therefore we would 
declare variables that held telephone numbers or zip codes with a data type of text. 



Programming TIP: Text is also referred to as a string or as an array of characters. Later in the eBook, we will cover 
the concept of arrays. Simply put, an array is a collection of variables all sharing the same data type. Therefore the 
word "Arizona" is a collection or series of characters stored together in an array. This is the why many languages 
refer to text as a string which comes from the idea of characters strung together as a collection in an array. 



Defining Variables Total = 0 PYTHON INITIALIZE AS 0 



Dim Total as Integer = 0 VISUAL ~BASIC.NET INITIALIZE AS 0 



int Total = 0; JAVA INITIALIZE AS 0 



Initializing Variables Total = 1 PYTHON INITIALIZE AS 1 



Dim Total as Decimal = 3.4 VISUAL ~BASIC.NET INITIALIZE AS 4 



longTotal = 10010100; JAVA INITIALIZE AS 10010100 



Referencing Variables Print Total PYTHON 



Console.WriteLine(Total) VISUAL ~BASIC.NET 



System. out printLine(Total); JAVA 



Assigning Variables Total = 6 PYTHON 



Total = 6 [VISUAL ~BASIC.NET 



Total = 6; JAVA 
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Table 2: Variable Activities (PYTHON, Visual ~Basii 



C.NET and Java) 



Program 



\ 



Variable: 
Total 




Computer 
Memory Locations 



Address: 100 



Address: 101 
Z 



text 



Address: 200 



Address: 201 



TOTAL - 66.32 



Figure 2: Variable value stored in memory. 



Variables make programming easier by allowing us to reference computer memory by name instead of by address. 
Here a value of 66.32 is stored in memory location 200. We can access it by its assigned identifier name of Total. At 
location 101, sits the letter Z from another computer program. 

CONSTANTS 

Another identifier, but probably less used than variables, are called constants. Again, its name might give it away. 
Whereas variables allow you to place different values in a memory location, a constant requires that you define 
the identifier with a value that will not change during the course of the program. 

You might want to use a constant to store a sales tax rate. This is not to say that a sales tax value would always 
stayed the same (we know that this is not the case) but the sales tax value would typically not change during the 
execution of the program. Making the sales tax value constant ensures that nothing could cause that value to 
change. 
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Will the calculation work as well if the sales tax rate is stored as a variable instead of a constant? Yes, the sales tax 
value will be the same whether it is stored as a variable or as a constant and calculations would yield the same 
result. 

Constants: Constants work exactly as their names states. A constant holds a value that will not change during the 
course of the program. Wherever use a constant you could also probably still use a variable. Constants add a level 
of safety to the program and protect values that should not change. The level of safety comes from protecting 
values from mistakenly being updated. 

Constants must be defined before they are used. They have accepted naming conventions and they also have data 
types. When a constant is defined a value for that constant must also be assigned. Constance can be numbers or 
they can be strings. Typically, most programming languages by convention will have all of the letters and the 
constant name capitalized. This makes the constant stand out in the source code and gives the program are 
looking at the code a hint that this is not a variable but a constant. 



Programming Tip: Most programming languages encourage programmers to capitalize all the letters in the name 
of the constant to make it stand out as different than a variable (i.e. SALESTAXRATE). Constants must always have 
their value set a declaration time. Failure to set that initial value at declaration will lead to a syntax error. 



Defining Variables TAX = 0 PYTHON 

Dim TAX as Integer = 0 VisualBasic.NET 



intTAX = 0; Java 



Note: constant names are by convention always upper case. 
Initializing Variables Initialization done when the constant is declared. 
Referencing Variables Print TAX PYTHO) 



Console.WriteLine(TAX)Visual ~Basic.NET 



System. out. printLine(TAX) ; Java 
Assigning Variables You can not assign new values to constants after declaration. 



Table 3: Constant Activities 
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LITERALS (STRING AND NUMERIC) 



A special data type which is common to all languages is a literal. A literal is more like a constant that a variable. A 
literal whether it is numeric or a string is a collection of numbers or letters which are assigned to a variable or 
constant. They exist to represent a number or series of characters in a programming statement. They are not given 
an identifier name but exist as just a number or set of characters. In the code example below, the value .08 and 
"AZ" are numeric and string literals respectively. They are used only once to complete the programming 
statement. In the example they are used with and assignment operator (=) to initialize a constant and a variable. 

TAXRATE = .08 
CurrentState = "AZ" 



Literals: Literals are like constants in that when they are set they cannot change. They are unlike constants in that 
they are typically used once and once only. Literals are typically found on the right hand side of the equals (=) 
assignment statement and are enclosed in either single (') or double quote (") characters (i.e. "Hello World"). 



Programming Tip: String literals are typically surrounded with double or single quotes. This signals the compiler or 
interpreter that a value has been created in the program that is an array of characters (could be numbers or 
letters). 



TIP: Variables, constants and literals can all be expressed in our modeling tools as nouns or adjectives that 
represent data values. 

In Practice: Using Constants to Make Maintenance Easy - One use for constants is to simplify program 
maintenance (this is always a good thing). The way this would be implemented is that values like sales tax rate or 
product prices would be set as constants at the beginning of the program and whenever those values were needed 
in an expression or statement the constant would be referenced instead of the number. Later on when prices 
change, the programmer maintaining the change would only have to change the constitution definition and the 
rest of the program would reflect that change automatically. The alternative would be to set the price value as a 
numeric literal throughout the program as needed. Under this scenario, the programmer maintaining this program 
would have to search out all of the prices that needed updating. If they miss any of the updates within the 
program, the program would still run fine but with the logic error. This type of logic error is very difficult to find 
and quite often goes unnoticed for a period of time. The error might not show up until month end processing 
shows inconsistencies in pricing. This is an expensive place to find a logic error. 



Status Check 

Name two common identifiers? 
When would you use a variable in logic? 
When would you use a constant in logic? 
How is a constant different than a literal? 

^^^^^1 The Process of Creating Programs | http://laptoppress.garymarrer.com 



CopyrlgfilcO malenal 



IDENTIFIER RULES 



Identifiers, like just about everything else that is used by a computer, have rules. When you create a variable or 
constant name you typically have rules regarding the number of characters that make that name, the kinds of 
characters that can be included in that name (i.e. typically, spaces are not valid inside identifier names), and rules 
concerning valid identifier names (i.e. you cannot have an identifier with the same name as a keyword). Every 
language is different but each language usually has restrictions regarding identifier name. The program language 
reference will the guide to resolving which of the rules apply and how. Some languages may permit a variable 
name to be up to 255 characters, others may not have any limits. As a rule, you want your name to be descriptive 
but not a typing test since long identifier names take longer to type. 



Keyword: Keywords are designated by the programming language as special words which correspond to program 
instructions sent to the operating system. They typically take the form of verbs like print or input and designate a 
program action. Keywords our special to the computer language and cannot be used for identifier names. 



IDENTIFIER DATA TYPING EXPLAINED 

A data type designates what kind of data will be stored in an identifier. For this chapter, the two data types we will 
focus on are numbers and text. Programming languages typically have three different ways of implementing data 
typing with identifiers. The first method is a type less implementation where the variable determines, based on 
what is being stored in it, what data type that variable will be. Type less programming languages have variables 
that store as either numbers or text. If the variable is first used with an assignment of a numeric literal, then the 
data type is numeric. If the variable is first populated with a string literal, then the data type is a string. With type 
less languages the data type is set automatically. 



Data Typing: Data typing involves the identification of the type of values stored in an identifier. The simplest data 
types are numeric and text (also called strings). Most contemporary computer languages support several different 
data types so that the programmer can maximize the efficient use of computer memory. For example, some data 
types (i.e. large floating point numbers) take up more space than other numeric data types (i.e. integers). 



Type less Data Typing: When a computer language is said to be type less, this means that it will probably only 
support two data types of numeric and text. Because the programmer cannot distinguish between these two types 
of numbers programmatically, the computer language automatically creates an area in memory to accommodate 
any possibility. The computer will assume that the number could be very large but in reality might be very small. 
This can leave much of the memory unused and therefore inefficient as compared to a strong data typed 
programming language that might have several data types to accommodate numbers. In the case of storing strings, 
the inefficiently is less prominent. 



More robust compiled languages, which are interested in processing speed and memory utilization, will have 
several different data types. For the most part, the data types are still numeric or text but there is much more 
granularity in terms of the size of the value being stored along with its format. These programming languages are 
said to be strongly data typed or strongly typed. For example, a data type of short might store and integer (a 
number without a decimal) that is no larger than 32,000 whereas a different data type called long might store an 
integer beyond trillions. The reason that both alternatives exist is that the shorter data type would require fewer 
bytes of memory then the larger data type. An efficient programmer would anticipate the size of the numbers 
used in his program and select the appropriate data type based on the size of the number. 
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There are also data types which do not fall under numeric or text specifically. Some of these other data types are 
Boolean, which will store a value of true or false. There are still other specialized data types such as Date which 
hold date values. Visual '"Basic. NET and Java are programming languages which have a rich set of data type 
options. 

A final data typing option exists with some programming languages that can support both type less and strongly 
typed identifiers. The most prominent of these languages is Visual ~Basic.NET. Its support of type less identifiers 
probably stems from the fact that the BASIC language has been constantly evolving in its 40 plus years of 
existence. Originally, BASIC supported three data types', integer, numeric and string. Newer versions of Visual 
~Basic.NET still support type less programming but encourage strong data typing of all identifiers. 

Strongly typed: Programming languages that are strongly data typed support several different identifier data 
types. This support of different data types makes the use of memory by identifiers more efficient. For example, 
when a program needs to store a numeric value, the programmer will determine if it needs to be an integer or 
decimal number and then the number of digits in the value (i.e. if the number stored less than on hundred or less 
than a million). Obviously, a variable that stores a number greater than a million needs to be larger than a variable 
that stores the value of less than one hundred. By using only the memory you need, you are creating a more 
efficient program. 



Programming Tip - It is a good idea to strongly type identifiers (if the language supports it). This is especially true 
when showing perspective employers your work. As more and more devices include processors with 
programmable environments, efficient use of memory will become critical. We now have the ability to create 
computer programs which execute on devices as small as a smart card, cell phone and PDA. None of these devices 
can accommodate the sloppy use of what amounts to a very small amount of memory. 



Data 
Type 



PYTHON -Visual Basic.NET 



JAVA 



As 

short -32,768 to 32,767 

Number 



-32,768 to 32,767 



Integer / As 

int Number 



-2,147,483,648 to 2,147,483,647 



-2,147,483,648 to 2,147,483,647 



Long / As -9,223,372,036,854,775,808 
long Number 9,223,372,036,854,775,807 



to -9,223,372,036,854,775,808 to 
9,223,372,036,854,775,807 



double 



-1.79769313486231570E+308 to 

As 4.94065645841246544E-324 for negative values; +/-4.9E-324 to +/- 

Number 4.94065645841246544E-324 to 1.7,976,931,348,623,157E+308 

1.79769313486231570E+308 for positive values 
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string Yes Yes 



Yes 



Boolean Yes 



Yes 



Yes 



Table 4: Different data types supported by PYTHON, Visual ~Basic.NET and Java along with the size in bytes of each 
data type. 

FUNDAMENTALS OF IDENTIFIER SCOPE 

Programmers are always looking for the most efficient ways to use memory. Aside from determining the correct 
data type so that the values cannot take up more memory than actually is needed, another way for programmers 
to more efficiently allocate memory is through variable scope. The scope of the identifier determines its lifetime. 
Some identifiers need to be present during the entire program and some identifiers can be used an they deleted 
before the program is stopped. 

When an identifier is designated to be available for the entire program it is said to have global scope. Another 
designation. Local scope indicates that an identifier is only available when the code is within the module. We will 
not make use of local scope at this time but will introduce it formally when we cover logic and code 
modularization. Block scope is the final type of identifier scope which is the most exclusive. This scope is called 
block scope. Block scope variables and constants are only available within a code block. The code block could be an 
if statement or a while loop and the identifier only visible while contained within the structure. Block scope will 
also be discussed later when we introduce code blocks. Below is a sample of global and local scope within a 
PYTHON program. PYTHON does not implement Block Scope but languages like Visual ~Basic.NET and Java do 
support block identifiers. 

Global, local and block scope: Global, local and block scope refer to the lifetime and visibility of the identifier. 
When identifiers are assigned with global scope, it is visible and callable from any statement at any time in the 
program. For global identifiers the lifetime extends to the end of the program. Local identifiers are more restrictive 
and are available for programming statements within a module. Block variables are the most restrictive and have 
the least visibility in your program. Block variables are used within programming structures like IF blocks or WHILE 
loops. Once you move outside of the module or block, local and block variables are said to lose focus and are not 
longer visible and accessible to the program. 



Key Concept: In the perfect world of our models, we are not concerned with variable scope or data types. We can 
assume that all variables are global and the data types of our models (Flowcharts and pseudo code) are type less 
(like PYTHON) and contain either text or numbers. 



In Practice: Why not make everything Global - I always get the question, "why not make everything global and 
reduce the risk of not having a variable visible later when you need it." Seems like an obvious thing to do. It would 
certainly eliminate syntax errors and might even make the program simpler to follow. The problem with global 
variables is that they can limit code reuse. If we design a block of code to be reused by several programs, we will 
want the module to contain everything it needs (identifiers, expressions, statements). For example, maybe this 
code calculates the monthly payment on a loan and if the variables are all contained in the code, we can simply 
move the module with a copy and paste to another program. 
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If the code includes global variables then we have a problem, we cannot just copy the code from program to 
program. If we call a global variable from within our program, we have now set a requirement to also implement a 
global variable in the new program. Again, this is not a complicated task but if we're trying to promote code reuse 
it only complicates reuse and introduces the strong possibility of a coding error. If something is to be a reusable, 
then all the code must be included within the reusable object. If it is not, then it is partly reusable ( and I suspect 
this is a contradiction of terms). 

PROGRAMMING WITH EXPRESSIONS 

All computer languages support expressions. An expression is a series of tokens (identifiers, operators, keywords, 
etc.) that support the assignment or return of some new value. We have seen expressions already in this eBook. 
When we assign initial value to a variable, we used the equity or assignment operator to place an initial value in 
the variable (i.e. Total = 100). Expressions can include mathematical calculations that return a number or a logical 
expression (also known as a Boolean expression since it returns only true or false). We will work with expressions 
throughout the eBook but for this chapter we will only concentrate on arithmetic expressions for simple 
calculations. 

Sample expressions: 

total = 100 + newSale 
red = -BoxColor 



Expressions: A computer program could be thought of as a series of statements that include expressions and 
keywords. Expressions are the building blocks of our logic in work and in hand with identifiers to manipulate values 
into solutions. In its simplest form, an expression might be a calculation. A more complex expression might return 
a value of true or false from Boolean expression within a decision structure (i.e. if statement). Much of the time 
spent learning your first computer language will be learning how to formulate expressions so that they are correct 
for both syntax and logic. 



In Practice: Breaking up is an Easier thing to do! - You have at your disposal the ability to create very complex 
nested expressions. You can decide to create one expression to calculate the cost of a sale or you can break it into 
pieces. Breaking it into pieces is almost always easier to understand and therefore will have less chance for error. 
You could create the same program outcome with two different sets of programming statements: 



# expressions test 

Cost = 100 
TaxRate = .08 
SubTotal = 0 
Total = 0 

DiscountRate = .05 
Discount = 0 

#Expression Version One 

Total =(Cost - (Cost * -DiscountRate)) + ((Cost - (Cost * -DiscountRate)) * 

-TaxRate) 

print Total 
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#Expression Version Two 
Discount = Cost * ~DiscountRate 
SubTotal = Cost - Discount 
SalesTax = SubTotal * TaxRate 
Total = SubTotal + SalesTax 
print Total 

Which expression(s) is easier to follow? 
Status Check 

Define data type and describe the benefits if a type less programming language? 

Define scope and the significance of global scope? 

Compare and contrast modifiers and keywords? 

Explain the difference between an expression and statement? 



PROGRAM LANGUAGE STATEMENTS DEFINED 



It is sometimes difficult to distinguish between statements and expressions. The primary difference is where an 
expression will return something to your program that can be used another programming instruction; a statement 
is a directive to the interpreter or compiler to perform some keyword function. For example, when we asked the 
program to print the variable total that instruction was a statement that contained the keyword print and the 
variable called total. There was no assignment or change to the variable. Statements will usually contain one or 
more keywords and some languages (like Java) require a special character (i.e. a semi colon) to terminate the 
statement. 



Statements: Statements include keywords, expressions and identifiers. They are the instructions executed by the 
compiler or interpreter. They constitute actions or verbs in our program. Put another way, they are the actions in 
our recipe. 



CODE BLOCKS 



As you will see in future chapters, programmers quite often groups statements and expressions together into code 
blocks. A code block may be created as a result of using a program structure, such as an if statement, to represent 
a logic decision or a while loop to repeat through a series of statements (both topics introduced later in the 
eBook). Code blocks area also created as a result of modularization where we break our programs into smaller sub- 
programs to make the program easier to understand and maintain. Modularization takes a divide and conquer 
approach to breaking complex problems into smaller problems each with their own code solution. Some 
languages, such as Visual ~Basic.NET, are built almost entirely on code blocks. As we saw earlier in the chapter, 
code blocks can have identifiers with their own level of variable scope. 



OPERATORS 



Operators are used within expressions to perform calculations or comparisons. Arithmetic operators are used to 
perform calculations where numbers are returned. Another type of operator is a logical operator which is used in a 
Boolean expression. Boolean expressions are a fundamental part of coding decision structures typically 
implemented as if statements. 
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For example, in the statement: 



if (total > 100) then color = "red" (total > 100) 

is a Boolean expression which will return a true or false value depending on the comparison of the value of total 
and the numeric literal value of 100. A Boolean expression uses different operators than what you would typically 
find in a calculation with arithmetic operators. Both sets of operators are critical in developing computer logic. 



Operators: Operators are the syntax that ties keywords and identifiers together. There several different kinds of 
operators. The operators we use in this eBook are arithmetic, logical and compound. These operators will allow us 
to do calculations, make decisions and loop through blocks of code. 



ARITHMETIC OPERATORS 

Arithmetic operators look very similar to the operator buttons on your calculator. Plus and minus our data calls to 
the addition and subtraction operators we learn an elementary school. Multiplication, division and exponentiation 
are different than elementary school but are very similar to what is found on other computing devices. With 
pseudo code, we may have spelled out these words or used the symbols. For our programs, we must use the 
operators in the expression format to get the desired results. 

Operator Operation 

+ Addition 

_ Subtraction 

/ Division 

* Multiplication 

or Exponentiation 

Table 5: Arithmetic Operators 



Arithmetic Operators: You've seen and used arithmetic operators in the past. Whenever you calculate numbers 
you're using arithmetic operators. Common operators are addition (+), subtraction (-), multiplication (*) and 
division (/). One of the differences in these operators from the ones we learned in elementary math is that the 
multiplication and division symbols are different than the ones that we first learned arithmetic from. The asterisk 
(*) is used to signify multiplication and the forward slash (/) is used to signify the vision. 



Pseudo Code Program Statement 

Profit equals Sales less Cost 
Profit = Sales - Cost 

Taxes equals Value times TaxRate 
Taxes = Value * TaxRate 

Amount equals Total times Qty divided by 2 
Amount = Total * Qty/ 2 

Cube equals number raised to three 
Cube = number**3 

Table 6: Arithmetic operators are determined from pseudo code (all of these statements would execute In 
PYTHON, Visual ~Basic.NET and Java but Java would have each statement ending in a semi-colon (;)). 

OPERATOR PRECEDENCE 
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Not all arithmetic operators are the same. Some operators have precedence over other operators. Precedence 
means that one operator will be performed before another no matter where the operator Is In the statement. The 
rules that govern which operator is resolved first are called operator precedence. For example, if you have an 
expression that includes an addition and multiplication operator, the multiplication operation is performed first. 
Multiplication has precedence over addition. Operating systems need clearly defined rules to resolve complex 
calculations. Operator precedence provides this. Operator precedence is standardized by operating system so it 
should be implemented the same whether you're programming in Visual Basic, Java or PYTHON as long as the 
operating system is the same. Knowing the precedence of the operators in the expression can greatly change the 
outcome. For example, what is the outcome of the following expression? 

A= 2 
B = 5 
C = 6 

Total = A + B * C 

If you answered 32, you are correct. This is because multiplication has a higher precedence than addition. 

Parenthesizes are the great equalizers in calculations. Parenthesizes has the highest precedence and are always 
done first. If I change the expression to the following, what is my answer? 

A= 2 
B = 5 
C = 6 

Total = (A + B) * C 

The answer is now 42 because the addition has taken precedence because of the parenthesis. Parenthesis can help 
you set the sequence of the calculation by forcing the highest precedence operation on compound operators. 
What happens with the following statements? 

A= 2 
B = 5 
C = 6 

Total = ((A + B) * C) 

The answer would be the same. When the compiler or interpreter sees multiple parenthesis in an expression it will 
resolve the calculation in the inner parenthesis first and the next outer set of parenthesis next and so on. You 
could have virtually an unlimited number of parenthesis but at some point this will probably make the calculation 
difficult to understand and it would be better programming style to break the statement down into multiple 
statements. 



TIP: Parenthesis need to always match. A match is a left parenthesis "("followed at some point with a ")". 
Unmatched parenthesizes will result in a syntax error. 



0 Parenthesizes 
** exponentiation 

*, /, % Multiplication, division, modulus 
+, - Addition, subtraction 

</ <=, >, +> Less than, less than or equal to, greater than, great than or equal it 



The Process of Creating Programs | http://laptoppress.garymarrer.com 



Table 7: Operator Precedence (Highest first) 



Most languages have more operators than what are displayed in the table. I've kept this list brief. You'll notice that 
some levels of precedence have more than one operator. In this case, if an expression has several multiplications 
operators, it will act on the left most operators first and then work its way to the right. For example, 

Z = A* B*C 

In this case, since the only operators are multiplication, we will multiply A times B and that result will be multiplied 
times the value contained in C. Same level operators are evaluated left to right. 

You'll notice from our chart that not only arithmetic operators have precedence, but also logical operators have 
operator precedence. 

LOGICAL OPERATORS 

There is one more set of operators yet to cover. Logical operators are used to place comparisons in expressions. 
Control structures make extensive use of logical operators. Logical operators and control structures will be covered 
in chapter four. 



THE SCENARIO - CACTUS BOOKS AND TAPES 



So far so good. The program you wrote to calculate customer price was a success. But as with most programs, the 
original design has now been reconsidered. Given the relative inexperience of the Chavez sisters in developing 
systems, it has been very hard for them to create formal requirements. As a result, after they see what you have 
done, they then think of more effective ways of making the book reservation system successful. You have 
determined the best way to develop the book order web page is to proto-type the system. 

Proto-typing means you will take the original requirements and develop the program with the idea that you will 
review the results with them and revisit the program with modifications after each new release. You know that this 
type of program development can be more expensive but given the experience of the Chavez sisters in developing 
new systems, the tradeoff seems to make sense and it is an approach that they are much more comfortable with. 

They have decided that some modifications need to be made on the cost charged the customer. They have been 
thinking about developing a loyalty plan for frequent customers loyal to the store. The calculation needs to be 
modified to give a loyalty discount (1.5 percent) if they enter their customer number. In addition, if they have 
purchased more than three books in the current month, they are given another $10 dollars off their order. The $10 
dollars is applied after all other discounts. 

You have decided to modify your original pseudo code to reflect these new requirements. You understand that the 
final program with need decision structures to provide a different logic path for loyal plan customers verses regular 
customers but you are only concentrating on the expressions at this point. 

Pseudo Code Logic Solution 

Start 

Input -WSCost 
Markup equals 1.25 
Handling equals 5 
LoyaltyBonus equals 1.5 per cent 
QuantityDiscount equals 10 

SubTotal equals WSCost times Markup plus Handling 
CustDiscount equals SubTotal times LoyaltyBonus less 10 
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CustCost = SubTotal less CustDiscount 

Print CustCost 

End 



TYPES OF PROGRAMMING ERRORS EXPANDED 

As first covered in Chapter two, regardless of the programming language used, programming errors fall under 
three categories. As a programmer, you will first encounter syntax errors as you build your programs and either 
compile them or run them through the Interpreter for the first time. Runtime errors and logic errors are typically 
uncovered later In the program development process while you are testing your programs. Below Is a summary of 
each and a discussion of techniques useful In helping resolve each type of error. 

DISCUSSION OF PROGRAM SYNTAX ERRORS 

We Introduced syntax errors In the last chapter. Syntax errors are caused when statements or expressions are 
Inconsistent and cannot be executed by the interpreter or converted Into machine code by the compiler. Common 
reasons for syntax errors are misspelled Identifiers and keywords, invalid program grammar in expressions and 
statements (I.e. If arithmetic operators are used In an Inconsistent manner). Errors that qualify syntax errors fall 
under a fairly broad category and each programming language treats syntax errors with varying levels of error 
detail. In other words, some programming languages provide syntax errors which are extremely Informative and 
help easily Isolate the problem. Other languages may not do much more than Identify the offending line In the 
program. 

Understanding Program Run-Time Errors 

Once a program has been compiled or has a statement has passed through the Interpreter without syntax errors, 
the program Is available for execution. If during execution a value Is processed or a resource Is accessed In an 
Inconsistent manner, the program stops execution and aborts with a runtime error. The error used most 
frequently discussed as a runtime error Is when an expression tries to divide by zero. Any number divided by zero 
Is mathematically Indeterminate and because of this the computer Is unable to return a value from the expression. 
When computer programs cannot execute program statements they will abort with a runtime error. If the runtime 
error Is not processed as an exception, the program will need to be restarted from the beginning. 

LEARNING ABOUT PROGRAM LOGIC ERRORS 

Program logic errors have always been the most difficult errors to Isolate. Logic errors do not return any error 
messages (syntax Is okay) and do not stop execution of the program (a runtime error). When a logic error occurs 
the program appears to be functioning normally. It Is only through rigorous testing that logic errors are caught by 
the programmer before creating a problem for the end user. 

Sometimes the problems appear Immediately but most of the time problems are not found until after the fact. For 
example, a calculation error on a particular product Item may not be dramatic enough for the user to see the 
problem when It first happens. At month end, the department might see In sales summaries a sharp decrease in 
Importance In sales. At this point the error might be a significant error and present a hardship to the organization. 
Only after returning to the software and reevaluating all the expressions and logic will you know if a logic error is 
present. This Is the reason that why a test plan is as Important as it helps to head off logic errors before they create 
bigger problems. 



In Practice: Everyone will have a story about the logic error that got away - Sooner or later all of you will have a 
logic error you will never forget. As I mentioned earlier. It's perfectly acceptable and expected to make mistakes 
but the important thing Is to learn from your mistakes and not let them happen again. My fondest memory of a 
logic error Involved a programming language called RPG II (RPG stood for Report Generator language). RPG 
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programs use the special variables called indicators to hold true or false values that indicated the outcome of the 
decision. You'll soon learn that all decisions processed by computer have only two outcomes, true or false. In my 
case, I had inserted a couple lines of logic which essentially provided special processing for a record that existed for 
one person a database of 20 thousand. This person had special processing performed on their monthly bill and was 
very vocal and adamant about having this special processing performed. As bad luck would have it, there always 
seemed to be a problem with processing data on this person's account. 

In my haste to make a change to accommodate this person, I failed to do the testing necessary to validate that the 
change would work correctly. I'll have to admit that the test required a fair amount of time. I took a bit of a gamble 
and short cut my normal testing. As luck would have it, the logic failed and approximately 10,000 customer 
invoices carried a line on their monthly bill indicating a reduction of $10.00. The $10.00 didn't affect the invoiced 
amount but needless to say it created a lot of confusion when customers tried to reconcile their bill. I would say 
that I will always remember RPGII indicator 55 as my favorite logic error. 



UNDERSTANDING PROGRAM EXCEPTIONS 



Let's go back to our discussion of runtime errors for just a second. I talk about the classic runtime error or a 
calculation that tries to divide by zero. This may have been caused by a user keying in a value of zero when the 
variable should not accept zero. This situation (invalid input) isn't all that unusual and we certainly do not want our 
program to abort just because a person keyed an invalid value. There is two ways to validate input information. 
One method is proactive using decision structures to test for the inputted value (inputValue > 0). One other 
method is proactive where the runtime error triggers an exception and that exception is processed gracefully by 
the program allowing the user to read key in the incorrect information. 



Exception: An exception is an event initiated by the operating system in response to a runtime error. You can test 
for particular exceptions and therefore create appropriate error messages and corrective actions based on the 
exception thrown by the system. 



TOOLS TO HELP RESOLVE ERRORS 

The only thing older than programming is programming errors. One of the productivity enhancements offered by 
many programming languages has been the development of sophisticated IDE software that will assist in locating 
and resolving errors. Online help (also known as real time interactive help), line debuggers and visual debuggers 
assist the programmer in making programs error free. 

ON-LINE HELP 

During the testing process, you'll uncover errors. Programmers are not infallible and we all create programming 
errors from time to time. Even if you are an experienced programmer, we all have to go back and review old topics 
or come up to speed on new programming language enhancements. On-help can be a great productivity aid for 
those situations. Online help is typically triggered by hitting a specific function key or by highlighting the error and 
hitting a function key. Some of the newer IDE's will even try to anticipate your questions by providing a running list 
of help topics. This is sometimes called dynamic help. 



PROGRAM DEBUGGERS EXPLAINED 
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There are two categories of debuggers generally available for programmer use. The most primitive debugger is 
command line based that allows you to issue debug commands to set breakpoints and watch points along with 
debugger commands to display identifier values. 

Once the breakpoint is encountered the program is halted. You can display identifier information along with the 
line number of the statement just processed. It's through the investigation of identifiers that you may get hints as 
to why the logic of the program is not working correctly. If a calculation is complicated, the debugger will help you 
break down the operations and help isolate the programming error. You can restart the program once you have 
inspected the logic and stop it with a breakpoint again if necessary. 

The newest form of debugger is more graphical or visual. This type of debugger graphically shows us the source 
code and the values of identifiers and the sequence of statements in a full screen display. Just like a picture is 
worth a thousand words, visual debuggers typically make the programmer more productive than line debuggers. 
PYTHON supports the line debugger and IDLE has a debugger built in that will both show identifiers and allow for 
the step through of source statements. They are not visual debuggers. The IDLE debugger tool is accessed via the 
Interpreter window. Visual ~Basic.NET makes use of the Visual Studio visual debugger. This debugger are has 
existed for a number of releases and is proven to be very popular. Debuggers in Java have also evolved overtime 
and exist in both in line and visual formats. 

DEBUGGING TERMS 101 



• Breakpoint - Most debuggers will allow you to specify statements where you can stop execution of your 
program and start a debug session. Most of the time you will not want to walk through every line of 
source code but instead focus on a section of code that you think might be in error. If you set a 
breakpoint, the program will stop on that line and the debugging can now begin. You can then continue 
with the rest of the program or check for more errors. 

• Watch point - You can flag specific identifiers to be set as watch points. A watch point will usually display 
somewhere on the screen and if the identifier changes for any reason, the display is refreshed and all 
watch pointed identifiers will have * Call Stack - If the debugger displays the call stack, it will show the 
execution sequence of statements and module blocks of code. This is useful for following the sequence of 
statement execution. Since many logic errors are caused by the program branching to code incorrectly, 
following statement sequence can be very helpful.. 

• Step In - Step In tells the debugger to move to the next statement. The call stack and watch point display 
will be updated. You can stop and query the values of local and global variables. 

• Step Over - Step Over is used when you want to move over a module code block and not step through the 
statements one by one. This is usually done when you know a block of code could not be part of the logic 
error and therefore stepping through the code would not be useful. 



Debuggers: There are three different debugger designs. Visual debuggers offer us the most flexibility and provide 
the greatest productivity improvements by allowing us to see our program execute line by line and inspect 
identifiers along the way. Lined based debuggers do essentially the same thing except through a debugger 
command prompt and not a graphical interface. Lastly if the computer programming language environment does 
not have a debugger, the programmer can always result to using print statements to show the values of the 
identifiers and follow the sequence of executed statements. 

Another important piece of information provided by the debugger is the flow of the program statements. We have 
not experienced this yet but as we get into decisions and looping, we may find that the code sequence we 
anticipated is not being executed as planned. We may have expected several statements to be executed as part of 
a complex calculation but in fact have found with the debugger that the logic we created has jumped over the 
correct statements thus giving us an invalid answer. 
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PUTTING IT TO USE 



The intent of this section Is to introduce the new programmer to standards and techniques frequently used by 
professional programmers. Topics in this section relate to concepts introduced in the chapter but with a more 
vocational or occupational focus for students considering a career in programming. 



Best Practices: Structured Programming Conventions and Standards - There are many reasons why you want to 
support programming standards In your program code. We will concentrate on three of them. The first reason is 
one we talked about earlier. When we use standards developed by the programming profession, we use 
approaches which have historically been successful for other programmers and therefore successful for us. A 
second reason involves the maintenance of our programs by other programmers. If we adopt standards and 
techniques that others are familiar with, then it Is likely changes to our program will be successful. Finally, we want 
to use standards to show others that we follow the standards of our profession. When we do this, we prove to 
those who are interested in hiring new programmers that we are professionals and follow approaches which will 
make us an asset to their organization 



NAMING CONVENTIONS 

Naming conventions have always been fairly consistent across programming languages. Parts of these naming 
conventions are based on identifier naming rules and others come from good common sense approaches to 
naming items. I've summarized some common conventions found with most programming languages: 

• Identifiers cannot have the same name as keywords 

• Identifiers should have short concise names that are specific but not so long as to slow down the 
programmer with a lot of unnecessary keystrokes 

• Care should be taken that identify are names specifically identify the data. For example, in identifier 
named TotalCost is not nearly as descriptive as TotalCost2004 . 

• Identifiers should not contain spaces or symbols which might have specific meaning to a programming 
language. For example, the # (number sign), can be used as an operator in some programming languages. 
Including a number sign within an Identifier name might like the lead to future problems. 



Bad Name Reason Better Name 



Cost Cost is too general and might lead to confusion InventoryCost 



V 



V is too short and almost Impossible to look at and understand the 
type of information it contains 



Variance 



TotallnventoryCostJanuary Too long of a name and hard to type 



TotlnvCostJan 



Tot Annual Profit 



Spaces not allowed 



Tot Annual Profit 
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Print 



Print is a reserved word for tlie progrannming language. It is a 

PrintReport 

program keyword. 



Table 9: Examples good and bad identifier names. 



NAMING STANDARDS 

You may have noticed in the preceding table that many of my data names consisted of two words and that the first 
letter of each word was capitalized. This form of naming identifiers is called the Pascal naming standard. Simply 
stated, it is capitalizing the first letter of each word within an identifier name. It is a version of another naming 
standard called camel casing. The difference between Pascal and camel casing naming conventions is that with 
camel casing the first word does not have its first letter capitalized but all trailing words have their first letter 
capitalized. Some languages, Visual Basic specifically, used Reverse Hungarian notation where identifier had a 
three letter prefix in front of the identifier name that would distinguish the data type of the identifier along with a 
name that identifies the value. Look at the table below for examples of these three naming standards. 



Pascal Camel Casing Reverse Hungarian 



TotalCost2003 totalCost2003 lntTotCost2003 



CustomerLastName customerLastName strCustLastName 



SalesTaxRate salesTaxRatge decSalesTaxRate 



Table 10: Popular naming standards. (Note: Under the reverse Hungarian standard int stands for integer, str stands 
for string and dec stands for decimal) 



CHAPTER REVIEW 



Chapter summary, highlights, key terms, short answer questions, quizzes and case studies to reinforce topics 
covered in this chapter. 

CHAPTER SUMMARY 

After finishing this chapter you should understand and in some cases, demonstrate the following topics: 
• Explain the processes used to create programs 



Chapter Review | http://laptoppress.garymarrer.com 



Developing programs from program logic 



o Programmers use standardized processes to benefit from the successful approaches created by 
other programmers and to create programs which follow industry standards to facilitate future 
programming maintenance. 

Define and explain the use of identifiers in computer program 

o Identifiers, such as variables and constants, allowing the programmer to store and read values 
from within the program logic. 

o Variables allow values to be identified by name instead of memory address and can change 
frequently within the program. 

o Constants allow values to be identified by name instead of memory address but are assigned a 
value a declaration which cannot change within the program. 

Describe and demonstrate identifier data typing and scope 

o Data types for identifiers provide for more efficient use of memory by providing different data 
types for storing identifiers of different sizes (i.e. small numbers versus very large numbers. 

o Scope identifies the lifetime and visibility of identifiers. 

Explain and differentiate between expressions, statements, code blocks 

o Expressions consist of a series of a dent of fires and operators to perform arithmetic calculations 
or logical comparisons. The result of the expression is to return a value to the program 

o Statements consist of keywords and expressions and provide instructions to the computer to 
perform a particular function operation. The key word print will cause applet to be sent to the 
computer display. 

o Statements and expressions can be organized into blocks of code that represent a particular 
submission of the entire program. The process of creating these independent code blocks is 
called modularization. 

Describe and demonstrate how arithmetic operators are used in expressions 

o Arithmetic operators are used in expressions facilitate the return of the calculated value . 

Explain and classify syntax, Run-Time and logic programming errors 

o Programming errors can be categorized into three scenarios (Syntax, Runtime, and Logic). 

o Syntax errors are the result of invalid programming statements and expressions. These errors are 
created during the compile process are while the program is interpreted. 

o Runtime errors are the results of programs that are put into an inconsistent state based on 
programming input. A runtime error caused the program to abort and if not processed with 
exception handling, the program will need to be restarted. 

o Logic errors are the result of invalid program logic and although will not create any system errors, 
the resulting solution is still incorrect. These errors are difficult to find due to the fact that error 
messages are not created and can only be identified with a comprehensive program test plan. 
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CHAPTER KEY TERMS 

Arithmetic Operators 
Block Scope 
Constants 

Data Typing / Data Types 

Debuggers / Debugging 

Declaration 

Exceptions 

Expressions 

Global Scope 

Identifiers 

Keywords 

Literals 

Local Scope 

Modifiers 

Operator Precedence 

Operators 

Statements 

Strongly Typed 

Typeless 

Variables 

Variable Scope 



PART 2 INTRODUCTION TO STRUCTURED PROGRAMMING 



CHAPTER 4 CONTROL STRUCTURE FUNDAMENTALS 
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IN THIS CHAPTER, YOU WILL LEARN HOW TO: 



• Explain the Importance of structured programming techniques in creating programs. 

• Explain the importance if controls structures to logic modeling and programming. 

• Define and implement sequence, decision and repetition structures with flowcharts and pseudo code 



INTRODUCING CONTROL STRUCTURES? 



It is now time to put a little magic in our logic and programs. So far our programs have been very safe and very 
simple. We have yet to stretch your ability or creativity with complex logic. That will all change with this chapter as 
we introduce control structures. We can now bring together the techniques covered in chapter's one through 
three with program control structures to solve problems we have conveniently ignored up to this point. Control 
structures will allow us to add two critical functions into logic. Specifically, these two missing pieces are decision 
making and repetition. These two control structures will give us the power to do far more complex processing and 
provide flexibility with logic that I have only hinted at up to this point. 

The logic instructions used so far have been straightforward and were absent of more sophisticated logic necessary 
for our program to solve complex problems. In the previous chapters, we have mentioned if statements and while 
loops but have yet to explain why they are used and implemented. Why are they are so important to 
programming? I might have been guilty of teasing you a little, but there is a method to this approach and also 
some madness. I wanted to focus your attention in the first section of the eBook on the importance of creating 
complete logic models. Logic models are often overlooked in programming classes or there is an assumption that 
the student already understands these concepts. The absence of a complete logic model leads to unnecessary 
code rework or worst yet a solution that is different than what was requested. 



Key Concept: Professional computer trade publications are littered with stories of computer programs gone badly. 
Usually a lot of time and money was spent on a solution that was different than what the customer wanted. This is 
usually caused by the programmer not listening carefully to the end user or short cutting on logic design. 
Programmers are people and people have miss and/or pre-conceptions about how things should work. It is very 
easy to get lost in the moment and assume rather than going back and verifying the solution. A good logic model 
that is validated with the customer is a great insurance policy in protecting the program from coming out different 
then what was requested. 



When modeling logic for a typical business problem, it does not take long before our models need to include some 
element of decision-making. As we have already seen in the Cactus Books and Tapes case studies, our ordering 
program processes data differently if our customer purchases more than three books. Whereas our previous logic 
examples have ignored the requirement for our program to include a decision, we can now build logic to include 
decision structures that will allow our program to branch down a thread of program code. In this chapter, we will 
learn how to implement techniques of structured programming. By using structured programming techniques, we 
will not only improve the quality of our logic but make programs easier to write, easier to debug, easier to 
understand and easier to maintain. 



In Practice: Procedural Programming - We will officially introduce procedural programming next chapter when we 
cover the topic of modularization but is appropriate to mention it with structures since it is a critical part of 
structured programming. When we develop programs using procedural programming techniques we implement 
our logic as procedures. Procedures, like structures, are blocks of code that represent some logic component of the 
entire program. For example, we might create a procedure to do calculate sales tax and another procedure to 
calculate quantity discounts. Both procedures might be necessary to create a customer invoice but both 
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operations stand on their own and can stand alone as logic inside a program. Structures are typically written as 
blocks of statement and are similar to procedures in that many times they stand alone and represent a piece of the 
entire solution. 



Structured Programming: Simply stated, structured programming is the implementation of three control 
structures. Structures can be thought of as blocks of code that allows programs to implement sequence, decisions 
and repetition. Sequence, decision and repetition structures each have one entry point and one exit point which 
provide an element of simplification and organization that makes programs easier to understand and maintain. All 
programming languages make use of these three structures in various ways. They are essential to performing the 
complex logic necessary in computer programming. 



With control structures (sequence, decision and repetition), we can also begin to represent a task as a series of 
related instructions. We can begin to look at some logic tasks as a series of related steps. For example, when use 
an if statement to implement a decision structure, the if statement has two branches which describe the logic 
outcomes of the Boolean expression. The Boolean expression consists of the comparison of two values which 
results in a true or false value returned. For example the Boolean expression (1 < 2) is true but (2<1) would be 
false. The outcomes are organized and defined within the if code block (or we could say within the control decision 
structure). 

An IF statement in pseudo code would look like this: 

if (1 < 2) then 

print "This is my true outcome" 

else 

print "This is my false outcome" 

The THEN keyword marks the start of the true branch and the else marks the start of the false branch. 

For example, if the customer purchased more than three books, a series of calculations and statements will be 
executed to derive the correct discounted cost. The cost calculation for the customer who purchased less than 
three books is different than the customer who purchased 5 books. Each possible scenario required a different set 
of calculations and statements. The control structure allows us to group more than one logic step into a group 
which represented some particular task. In this example, the task is the calculation of cost. 
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Decision 
Structures 



True 
Branch 




if qty >= 100 then 

discount equals .04 

True 
Branch 



(f qty >= 100 than 

discount equals .04 

«l$e 

discount equals .01 




I 



False 
Branchi 



Figure 1: A decision control structure - If Block 

If you're a customer visiting that bookstore and you purchased five books you would certainly expect the 
calculations to reflect the quantity of books purchased. If the computer software cannot support this level of logic 
flexibility, the program is not very useful. Control structures will help us meet this challenge. 

Control Structures: Programming languages that support complex logic (i.e. like logic decisions) will implement 
sequence, decision and repetition structures. These structures will provide the programming flexibility necessary 
for computer programs to solve complex problems. Control structures enable the grouping of processing steps, the 
implementation of decisions and the use of repetition in our logic and then our programs. 

What will remain the same from previous chapters is the importance of proven programming processes. We will 
still use the program development process to first create a logic model, then create our programming code, next 
test our program and finally implement the program. What will be different is that our logic solutions (and 
therefore our programs) will include sequence, decision, repetition structures. 

CONTROL STRUCTURES DEFINED 

• Sequence structures are the simplest of control structures to implement and the closest in format to 
what we have discussed in the eBook so far. Sequence structures have one input and one output within 
the sequence structure and typically consist of instruction(s) (i.e. a calculation or maybe an assignment). 
The result is passed on to the next structure. Sequence structures appear as rectangles in flowcharts and 
statements in pseudo code. 
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Pseudo code example: 
total = sales times salesTax 



^ start ^ 



total - sales * 
salegTas 



Sequence Structure 




end 




Figure 2: Sequence structure flowchart 



• Decision structures, also known as selection structures; provide our program logic with the ability to test 
a Boolean expression that will return a Boolean value of true or false. The test constitutes a decision in 
our logic. The Boolean expression typically consists of two identifiers, literals or other expressions joined 
by a logical operator. It is important to understand that Boolean expressions can only produce a solution 
with two alternatives. By nesting (adding new decision structures within the true and false branches), 
even complex decisions can be implemented in a program. Decision structures appear as diamond shaped 
symbols in flowcharts and are implemented in pseudo code as an if statement. The flowchart diamond 
symbol (which also identifies the Boolean expression) will have a true line and optionally a false line 
drawn from the points on the diamond. Pseudo code will include statements indented under the if 
statement for true Boolean expressions and under the else statement for a false Boolean expression. 

Pseudo code for .10 percent book discount with purchase of more than 3 books: 

if (books > 3 then 
totSales = sales * .90 
else 

totSales = sales 

Flow Chart for .10 percent book discount with purchase of more than 3 books: 
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tDtSales = sales 




Figure 3: Decision structure flowchart 

• Repetition structures, also known as looping or iteration structures, provide our program logic with ability 
to repeat a block of statements based on the evaluation of a Boolean expression. This structure allows us 
to take a group of several statements and repeat their execution based on some decision or condition. 
The repetition could be as simple as iteration that allows us to repeat through a block of code a certain 
number of times or can be as complex as repetition based on a Boolean comparison (i.e. when sales > 
1000). Like the decision structure, the repetition evaluates a Boolean expression to control reentry into 
the loop. Repetition structures appear as a diamond with a line returning above the diamond to facilitate 
repetition and another line showing the flow of the logic when the loop concludes. In pseudo code and 
program code, the repetition structure is usually implemented with a while loop and has the statements 
included in the repetition indented under the while loop. 

Pseudo code to repeat a sequence statement 10 times: 

while cnt < 10 
total = cnt * qty 

Flow Chart for to repeat a sequence statement 10 times: 
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Ftepetition Structure 




Figure 4: Repetition structure flowchart 
Status Check 

List and differentiate the three control structures covered in the text. 
What is a Boolean expression and how is it represented in a flowchart? 
What is the symbol for a sequence structure? 



LOGICAL OPERATORS 



We will save our detailed discussion of logical operators until next chapter on structured programming. In this 
chapter, we will first introduce logical operators and get started with structured programming techniques. Logical 
operators are used primarily to test for a relationship. Logical operators are the > (greater than), >= (greater than 
or equal), < (less than), <= (less than or equal) and finally the == (equity operator). 



Key Point: Some languages use the = (equals sign) both as the assignment operator (when we want to make a 
variable equal to some other variable or literal) and the equity operator (i.e. used to test if two variables, two 
constants or a variable and constant, etc. are the same). Many of the newer languages (i.e. Java) have a double 
equals sign (==) for equality operator and a single equals (=) for the assignment operator. You will want to check 
the language reference to know which one to use. 



Equity operator If total == 1000: PYTHON 

If total = 1000 then [Visual ~Basic.NET] 
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If (total == 1000) Java 



>, >= Greater Than Operators If total >= 1000: PYTHON 



If total > 1000 then [Visual ~Basic.NET] 
If (total >= 1000) Java 



<, <= Less Than Operators If total < 1000: PYTHON 



If total <= 1000 then [Visual ~Basic.NET] 



If (total <= 1000) Java 



Logical Operators: Logical operators are used when we need to make comparisons in expressions. The result of a 
comparison with a logical operator is usually true or false. The logical operators are >, <, >=, <= and ==. The logical 
operators allow us to compare some predicted relationship (i.e. StateCode == "AZ") and if the conditional 
expression is valid then the program returns true. If it is not, it returns a false. We used logical operators 
extensively in if statements (covered in our next chapter). 



Programming Tip: Make sure you place the equals sign after the > and < for greater than or equal (=) and less than 
or equal to (<=). To reverse the characters will lead to a compiler or interpreter syntax error. 



COMPOUND OPERATORS 



This final group of operators is associated with logical operators and is called compound operators. Compound 
operators are used to join multiple expressions typically made up of logical operators. Logical operators consist of 
the and, or and not keywords. 

• When we use the and compound operator, we are testing that both sides of the expression evaluate as 
true. 

• When we use the or operator, we are expecting at least one side of the multiple expressions as true. 

• The not operator allows us to test for the opposite of true. 
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Below is a decision table. Decision tables are a popular way of showing the outcome of the entire compound 
statement by evaluating the outcomes of the two Boolean expressions contained within the compound statement. 
If you look at the first compound and expression, you will see the first expression is true and the second expression 
is also true. Since both expressions by themselves are true the entire expression is true. For the other values, at 
least one side of the entire expression is false so the entire statement is false. 

Boolean expression One 

A>4 

Boolean expression Two 
B > 5 

Entire Compound Expression Outcome 
A = 6 (True) B = 6 (True) True 
A = 4(False)B = 10 (True) False 
A = 7 (True) B = 3 (False) False 
A = 4 (False) B = 3 (False) False 

Table 8; Decision table for compound statement AND compound operator 

With the or compound operator only one side of the compound operator expression has to be true. For the first 
three values, at least one or both side is true. For the last line, neither side is true so the entire compound 
expression is false. 

Boolean expression One 

A>4 

Boolean expression Two 
B>5 

Entire Compound Expression Outcome 
A = 6(True)B = 6(True) True 
A = 4(False)B = 10 (True) True 
A = 7 (True) B = 3 (False) True 
A = 4 (False) B = 3 (False) False 

Table 9; Decision table for compound statement IF compound operator 
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Programming Tip: Many languages use different terminology for logical operators. You might also see relational 
operators and compound operators referred to as conditional operators. Compound operators frequently show up 
as keywords (i.e. and, or and not) but most commonly as & (ampersand) for the and, | (single bar) for the or 
operator and Not is frequently shown as an I (Exclamation) symbol. 



Key Concept: A block of code refers to a series of logic or programming instructions that are executed together as 
a group. This eBook will also refer to if blocks as if statements and if structures. Decision and repetition structures 
both use blocks to execute statements related to the outcome of a Boolean expression. 



Compound Operators: Compound operators allow us to join multiple logical expressions (expressions that contain 
logical comparisons). These operators come in very handy for complex decisions that have several components 
included in the decision logic. 



Status Checl< 

Why are relational operators used in Boolean expressions? 

What is the difference between or and when used in a Boolean expression? 

IMPLEMENTING SEQUENCE STRUCTURES 

Of all of the control structures, we are most familiar with sequenced structures. We have been using sequence in 
the examples covered in earlier chapters. A sequence structure represents a process step. An important part of 
system theory is that there is one input to the process and one output. All control structures, including sequence, 
represent the processing step in systems theory. The systems theory rule of one input moving into a process and 
finally to one output returned is central to the correct use of control structures. 

FLOWCHARTS EXAMPLE OF SEQUENCE STRUCTURES 

The sequence structure is drawn on a flowchart with two arrows and a rectangle. One arrow points to the top of 
the rectangle and represents the entry point (input). The rectangle represents the process and within it a short text 
message should explain what that step will do. A final line will drop from the bottom of the rectangle and 
represent the exit point (output). In (Figure 5) a single sequence structure. Please note that the example structure 
is a template and is unlabeled whereas typically it would contain information on what this sequence structure 
would perform. 
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Start 









'Hello 


WorlcT 




Figure 5: A Sequence Structure demonstrated in an actual application. The sequence structure includes an 
assignment where the msg variable will hold the literal "Hello World." 

COMMON SEQUENCE STRUCTURE FLOWCHARTING MISTAKES 

Sequence structures are the easiest of the control structures to flowchart. Mistakes made on sequence structures 
usually have to do with forgetting to add both an input and output line to the top and bottom of the sequence 
structure rectangle symbol. A sequence symbol that only outputs or only inputs data is incorrect. 
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Incorrect - the sequence struct jm 
must tave an input line and output 
line, Sequence Stmcture A only Kas 
output 





Correct -Sequence structure A has 
both Input and ouftput llns 



Figure 6: Example of valid and invalid sequence flow chart 



RULES OF FLOWCHARTING CONTINUED 



Flowcharts are designed to provide a flexible graphical alternative to pseudo code for representing computer logic. 
With pseudo code, we have rules regarding the construction of pseudo code statements and recommendations 
concerning the formatting of pseudo code (i.e. certain statements should be indented to add clarity to the logic). 
Flowcharts also have rules that should be observed when using drawing structures. Flowcharting rules are a 
combination of requirements necessary to implement structures correctly and also to make the chart easier to 
read. 

Below I have listed some of the important rules you will want to take in consideration when designing flowcharts. 
As with so many topics covered in this eBook, we cover only the fundamentals of flow charting. To complete your 
understanding of flowcharts would require some additional study and more practice that is asked for than with 
this eBook. One of the more popular software tools used to create flowcharts is Microsoft's Visio software. 

• Never cross lines in your flowchart even if the positioning of the symbols leaves you little alternative. It 
may take high level of artistic effort to space your symbols to avoid having the lines cross but if you're 
structure is to be drawn to the rules of structured programming, lines cannot touch. Touching confuses 
the requirement of one input and one output. 

• Each symbol should be labeled with information describing the activity of that symbol. For decision 
structures, which we will cover shortly, make sure each branch is labeled as to whether it represents the 
true or false outcome and the diamond symbol should include the Boolean expression. Sequence 
structures should have a text description of what is performed on that step. 

• Complete flowcharts should always start with a terminator symbol labeled start and conclude with a 
terminator symbol labeled end 

• If a flowchart needs to be drawn across multiple pages, as is quite frequently the case, the line drawn 
from the last symbol on the page should contain a off-page connector symbol (represented in flowcharts 
as a figure that is square on one side and pointed on the other -similar to the home plate on a baseball 
diamond) with a number contained within it. You should start the next page with the connector symbol 
and the corresponding connector number to indicate where the line continues from the previous page. 

PSEUDO CODE EXAMPLE OF SEQUENCE STRUCTURES 

A sequence structure is represented in pseudo code as a line of instruction. We have discussed in earlier chapters 
the relationship between pseudo code and flowcharts. A pseudo code statement representing sequence would 
typically contain text very similar to what is found within the rectangle of the flowchart. Below, I have included two 
examples of sequence pseudo code. 

message equals "Hello World" 
profit equals sales less cost 



Background Information: Where Program Structures Fit Historically and Today - Structured programming became 
popular in the nineteen seventies as a reaction to poorly constructed programs. Poorly constructed programs were 
difficult and time consuming to maintain. Time is money and programs that are poorly written take longer to 
develop and maintain. Structured programming methodologies used structures to organize logic and make it easier 
to maintain. Programmers using these techniques were more effective and could do more in less time. This was a 
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considered a great benefit to the organization. The development of structured programming techniques was one 
of the first developments that encouraged the training of disciplined programmers who developed programs using 
standardized proven professional techniques. 



USING DECISION STRUCTURES 

Sequence structures are certainly an important part of program logic but decision structures bring a flexibility and 
power to our programs that really make programming worthwhile. It is seldom the case that the stepwise format 
of sequence structures alone can handle the complexity necessary for a program to solve even a very simple 
problem. 

Decision structures are typically implemented with if statements. If statements will always contain a Boolean 
expression that will consist of logical and compound operators combined with identifiers and expressions. When 
evaluated, the Boolean expression will return a value of true or false. If statements support decisions by providing 
a branching of code via the evaluation of a Boolean expression. If the Boolean expression is true, the true branch is 
followed and a set of instructions associated with the true branch is executed. An if statement can optionally 
execute a separate set of instructions (identified with the else keyword) if the Boolean expression value is false. 

Bottom line, a single decision structure implemented with an if statement can only have two outcomes. One if 
branch is executed when the Boolean expression is true and one if branch is when the expression is false. By 
combining decisions structures with other control structures (this process is referred to as nesting) or sequence 
and repetition structures, we can create complex logic within our program to handle a variety of decision 
scenarios. We will show the power and flexibility of nesting control structures later in the chapter. 

If statements can be used in a variety of formats and based on the decision that needs to be implemented. Along 
with if statements, many languages support the case key word which is another alternative when implementing a 
decision that has multiple outcomes. We will spend time on both of these topics with flowchart and pseudo code 
examples of each. 
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Figure 7: Single Branch And Two Branch If Statements. 



SINGLE BRANCH IF STATEMENTS 

If statements can be implemented two different ways. An if statement can be implemented with a single true 
branch (true), and if statement can be implemented with two branches (true and false). We will talk about single 
branch if structures first since they are typically the easiest and least complicated to use. 

Single Branch IF Structures: Decision structures are usually implemented as If statements and a single branch if 
statement provides for a block of instructions to be executed if the associated Boolean expression evaluates as 
true. It is a requirement of an if block to contain at least a true branch. This if statement does not respond to a 
false decision. 

FLOW CHART EXAMPLE OF SINGLE BRANCH DECISION STRUCTURES 

Early in the chapter, we showed a flowchart of just a decision structure. This first flowchart included both true and 
false branches. In this section, we will diagram a real life implementation of a single branch decisions structure. We 
will save the two branch if statement for later. 

Many decisions in program logic need to only test the existence of a true condition. For example, I may need to 
apply a quantity discounts percent (.05) when the books purchased exceed a quantity of three. I can implement 
this decision with an if statement by testing the quantity variable and if that variable is greater than three, include 
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in the true branch sequence structures necessary to make the appropriate calculation. If the quantity is less than 
three the true branch will not be executed in the discounts not applied. In this scenario, a false branch is not 
necessary. There is no logic requirement to create a different calculation if the quantity of books is less than three. 
This is illustrated in Figure 8. Note: This diagram is of just the decision structure and not the entire program. 



Figure 8: IF statement example with single true branch 



COMMON DECISION STRUCTURE FLOWCHARTING MISTAKES 

A common error made with decision structure flowcharts is combining multiple logic paths together below 
decision structures. Although, it may seem perfectly logical to connect branches from separate if blocks into one 
line to continue to the next structure, it is not legal structured programming. Drawing a flowchart in this manner 
would is invalid because each if block should have its own output and not a shared output with other if structures. 





-True-i 



TotCcisi = TotCost 
" .0.05 
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Figure 9: Example of an decision structure in sequence structure that share the sanne output line instead of having 
their own output line 

PSEUDO CODE EXAMPLE OF SINGLE BRANCH DECISION STRUCTURES 

When implementing decision structures with pseudo code, the formatting of the information is important in 
ensuring that the true and false branches are clearly defined. With most decisions structures, each branch will 
typically contain a series of other structures. To highlight the structures that fall under each branch, the pseudo 
code the statements belonging to each branch are indented to show the relationship to the branch. Examine the 
following pseudo code example: 

booksQty equals 3 

if bookQty >= 3 then 

discount equals .05 

totCost equals totCost less (totCost times discount) 
print TotCost 



Logic Tip: The TotCost calculation within the if block may look a little mysterious. Here we have a statement that 
includes an assignment and an expression. The TotCost variable is used no less than three times in this one 
statement. So how do the values in TotCost change when this statement is evaluated by the operating system? 
Using operator precedence, the TotCost times discount expression is calculated first. 100 * .05 = 5 so this 
expression is equal to 5 which is now deducted from the current value stored in TotCost of 100. The subtraction is 
performed and the new value of 95 is stored in TotCost . 



In this pseudo code, the Boolean expression is booksQty >=3. Once this Boolean expression is evaluated an 
outcome of true or false will be returned. If the outcome is true, the sequence structures of discount equals .05 
and TotCost equals TotCost less (TotCost times discount) are executed. If the booksQty variable had a value of 2, 
then the Boolean expression would have evaluated as false in the discount calculation would have not been 
performed. This would be the correct logic solution to process a quantity discount when the customer purchased 
three are more books. 

We have discussed logic errors frequently in the eBook so far. If we took the following pseudo code and changed 
the logical operator in the Boolean expression so that it looked like this: 

if booksQty > 3 then 

The program would execute correctly for all values except for the current example where booksQty is initialized to 
have a starting value of 3. The way the Boolean expression is written, a value of 3 would not get the discount. This 
is not how the program should work and the incorrect logical operator or > would represent a logic error. To test 
this logic, you would want to test the program when booksQty equaled a value less than 3, a value of three and a 
value greater than 3. This would test all three scenarios possible with a logical operator. 



Programming Tip: In some programming languages, if statements have strict formatting requirements (spaces 
indented on branches) and in other programming languages there no formatting requirements. No matter what 
the programming languages requires, it is considered good programming practice to line up the if the word with 
the else keyword and have the branch statements below all indented the same number of spaces. This makes the 
logic much easier to understand and also helps to prevent logic errors. 
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In this code snippet, we have a variable called the booksQty which has been initialized with a value of three. The if 
statement has a Boolean expression that tests to see if the booksQty is greater than or equal to the value of three. 
Since the Boolean expression will evaluate as true, the statement associated with a true branch (TotCost = TotCost 
* Discount) will execute. Note: The If statement ends with a colon and the true branch has each of the statements 
indented to the same character position. 



In Practice: Boolean String Comparisons - Letter Case Counts: When working with strings (a series of characters) in 
Boolean expressions the letter case of the values stored in those string variables or string literals is important. For 
example, let's say I have two string variables called carColor and modelColor. Each of these variables holds 
information specifying a color. Color is spelled out as a string (i.e. carColor might contain the value "red" for a red 
car). 



Look at the following pseudo code? Which branch would the if statement take and why? 

carColor equals "red" 
modelColor equals "Red" 
if carColor == modelColor then 
print "Color is identical" 

else 

print "Color is different" 

If you said the false branch you would be correct. The reason for this is that the value stored in carColor (lowercase 
"red") is different than the value stored in modelColor (title case "Red"). Letter case counts when comparing the 
contents of string variables and literals. If the letter case is not the same then there will be no match so the 
expression will evaluate to false. Does this make sense? If you did not account for the letter case of the color, you 
could introduce a logic error into the program. 



Key Concept: When a language is said to be case sensitive is makes a distinction between the letter case of 
identifiers and keywords. totCost is a different variable than TotCost because the case of the letters are different. 
Java and PYTHON are case sensitive but Visual Basic is not. 



TWO BRANCH IF- THEN-ELSE STATEMENTS 

Not only can a decision structure have a true branch but you can also define a branch for a false outcome. In a 
flowchart, this is done by drawing a line from one of the other points on the diamond and labeling that line as false 
(or No). In pseudo code and PYTHON, creating a false branch is done by using the else keyword. Many of the same 
rules that were established on single branch decision structures are true with two branch decision structures. We 
still need the Boolean expression that contains at least one logical operator and we need a true and false outcome 
defined. 



Two Branch Decision Structures: The decision structure allows the programmer to add a false branch for the 
Boolean expression. The false branch implemented with the else keyword can contains other structures just as the 
true branch did. The false branch is optional. 



FLOWCHARTS EXAMPLE OF TWO BRANCH DECISION STRUCTURES 
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In this flowchart example, will modify our single branch example to include a slightly different calculation if the 
book quantity is less than three. If one or two books are purchased, we want to award a half a percent discount. 
This calculation will need to be made on the false branch and we will leave the true branch as it was earlier. You 
can place a true/false, T/F, yes/no or Y/N label on the line extending from the diamond to identify which branch is 
true and which is false. Although it is not a standard, the true branch is typically on the right and false on the left. 
Whatever technique you use, try to be consistent as to not to confuse the reader. 




TotCosI = TotCosI 
' ,0,005 




TotCost = TotCcsst 

' .0-05 














Figure 10: IF Statement with true and false branch 



PSEUDO CODE EXAMPLE OF TWO BRANCH DECISION STRUCTURES 

All of the rules that applied with single branch pseudo code also apply to two branch pseudo code, with the 
exception that we now have a new key word, else, placed in our if block. We identify the false branch with the else 
keyword. We will want to format and tab the decision structure so that both true and false branches are indented 
the same from the if statement and the else keyword. Below is an example of our two branch decision structure 
using the if and else keywords. 



booksQty equals 3 
if booksQty >= 3 then 
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Discount equals .05 

totCost equals -totCost less (totCost times discount) 

else 

discount equals .005 

totCost equals totCost less (totCost times discount) 
print totCost 



The else branch here represent the actions taken if the Boolean expression is false. 

As we begin to implement structures, and specifically decision structures, you will increase the likelihood of logic 
errors, if statements are notorious for passing syntax checks but failing with logic errors. It is very easy to construct 
complex decision structures and think that the branching is correct only to test your application and find that the 
branch you expected is not the one taken by the program. Debuggers provide a picture of how your program 
works by allowing you to follow code as executes and inspect the values store within variables. Short of using a 
debugger, you can also do a desk check, or visually inspect your code for errors but chances are if you wrote the 
logic incorrectly you may be biased in reading it for errors and miss the error. There is no substitute for using a 
debugger and watching the program execute its instructions. 

NESTING DECISION STRUCTURES 

Single and double branch decision structures are very similar. Typically, if you understand how to implement an if 
statement with a true branch then implementing the false branch comes pretty naturally. The nesting of decisions 
structures describes the situation where one or both of your branches contain a new decision structure. We define 
nesting decision structures as a scenario where one or both of the branches includes a new decision structure. In 
short, this means one of your if statement branches executes another if statement. There are no practical 
limitations as to how far this nesting can occur. As long as the syntax rules governing if statements have not been 
violated, the compiler or interpreter will let you nest decisions structures as many ways and times as you would 
like. From a practical standpoint as you move to two, three or four levels of nesting, the entire decision structure 
becomes very complex and difficult to debug. Just as we took complex calculations and broke them up into smaller 
calculations the same benefits would apply to breaking large complicated if blocks in to multiple smaller if blocks. 

Key Concept: Now that we have discussed decision structures, you see that a decision implemented in a computer 
program can only have two outcomes. It can be true or false or yes or no (whatever you prefer to use). This is 
pretty primitive. Hard to understand how this is very powerful but it is. What you can do with decisions is nest 
them into a series of true/false decisions. Complex decisions are implemented as a series of simple true/false 
decisions. Since the computer can execute decisions very quickly and can keep all of the outcomes organized, it 
can become a very used tool for automated decision making even with the limitation of only being able to support 
two outcomes. 

FLOWCHART EXAMPLE OF NESTED DECISION STRUCTURES 

The flowchart rules for nested decision structures are the same as the rules for single and double branch decision 
structures. In our flowchart, we would see the nested decision structure appear as a second diamond hanging off 
the point of another diamond. The first diamond would represent the primary decision structure and the second 
decision structure and would represent the nested one. I have drawn an example of this and figure 11. 
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Figure 11: IF Statement with nested IF statement 



PSEUDO CODE EXAMPLE OF NESTED DECISION STRUCTURES 



All of the rules that applied with single and double branch pseudo code also apply to the nesting of if statements. 
In the example below, I have nested an if decision statement off of the true and false branch of the primary if 
statement. 

booksQty equals 3 
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if booksQty >= 3 then 
discount =.05 
if loyalty = true then 

discount = discount plus .003 

else 

discount equals .005 

if loyalty = true then 

discount = discount plus .001 
totCost equals totCost less (totCost times discount) 
print totCost 

This is the first decision structure (implemented as an if statement). 

Here we have the second nested decision structure (also implemented as an if statement). 



In Practice: Business Rules - A common expression used to describe business logic as business rules. A business 
rule is computer logic that defines some set of program structures used by an organization in the day to day 
operation of their business. For us, we could look at the loyalty purchase program used by Cactus Books and Tapes 
as a business rule. It qualifies as a business rule because it's a set of logic which defines the discount given to a 
customer who makes frequent purchases. We know from our previous work in chapters two and three that this 
business rule can be converted into a logic model and implemented via a program. This is just one business rule of 
many at Cactus Books and Tapes. Business rules are defined by the end user during the requirements phase of 
SDLC and implemented as a logic model first and then program code in the design phase.. The next time someone 
talks about a business rule you'll know exactly what they're referring to and how it is implemented in a computer 
program. 



Status Check 

Why do not all if statements have a false branch? 

Why must a sequence structure have a line draw into and from the sequence structure symbol? 
What does nesting of structures mean? 



USING REPETITION STRUCTURES 



Our final control structure is the repetition structure. Repetition structures allow us to repeat logic steps based on 
Boolean expression criterion. The Boolean expression sets the criteria for how many times a block of logic (or 
code) will be repeated. We may need to loop through a block of code once or several times. We may know the 
number of exact repetitions in advance or it may only be known at run time when the program is in use. 

Let's discuss an example of how repetition structures simplify program logic. Let's say that we have a program 
requirement to prompt the user for customer data. We will need to collect the customer's name, address and 
customer number. This data once collected will be stored in a data file for later use. Based on conversations with 
the customer service department, we know that the customer service rep using this program may need to enter 
one customer or hundreds of customers during their shift. 

The first problem we have is how to efficiently code our solution so that it gathers the three pieces of customer 
data for many customers. Based on what we have learned so far, and excluding repetition structures, we would 
have to repeat the same three logic instructions for however many customers we had to collect data from. If we 
collected information from 300 customers then our program would have at the very least, 300 customers times 3 
lines of logic for a total of 900 lines of logic. We know from past experience that each of those logic instructions 
would probably translate into a line of programming code. Without repetition structures, we would have a 
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program with over 900 lines of logic. Not only would this be extremely tedious to program but also very difficult to 
maintain. 



Without the use of repetition structures, we also have another problem. When we put the logic together for the 
solution, exactly how many customers should we plan on processing? Is it 50 customers, 197 customers, or 1000 
customers? Since our program will need to be coded to accommodate however many customers we will be 
collecting data for, can we realistically determine what this program should look like in advance? Do we have to 
have several programs? Would we have one program that collects data from 50 customers and one program that 
collects data from 197 customers and finally one program that collects 1000 customers? I hope not. What if we 
only one to collect data from three customers? Without repetition structures we would have many versions of the 
same program that each could accommodate a different number of customers. Would it not be better to have one 
program that would work for all? Yes it would. 

Now let's consider the same problem but this time, we will have repetition structures available for our solution. A 
repetition structure has a Boolean expression which determines if a block of statements is repeated or is passed 
over. In the problem of collecting customer information, we could create logic which says that if, the letters "QQ" 
are keyed in for customer name than we have loop through the code enough times to collect all of the data and 
now wish to move on to the next stage of the program. With this design, the program could be used for a zero to 
an infinite number of customers. "QQQ" would dictate when the program ends. There would be no need for 
multiple programs and even with the extra lines of logic to accommodate the repetition structure, the executable 
code be small and the same for no matter how many customers were being processed. The program logic could be 
written in four lines and work just as well for 1 or 10000 customers. 

Unlike decision structures which are primarily implemented with if statement logic, we have more variability and 
options with repetition structures. For starters, the Boolean expression which determines whether the repetition 
will occur can be done at the top (pre-test) of the logic block or at the bottom of the logic block (post test). Just like 
the if statement is typically used for decision structures in most programming languages, the while statement is 
the most common way of programming repetition structures. 

Logic Tip: Loops, looping, iteration and repetition - You will see all four of these terms used identically when 
describing repetition structures. They all mean essentially the same thing but iteration is more closely tied to 
counting through a number of loops. Iteration is done best with another repetition structure called a for loop. 

PRE-TEST REPETITION STRUCTURES 

Pretest repetition structures are implemented in while loops. It is called a pretest structure because the Boolean 
expression is evaluated before any of the code inside the while block is executed. The while block consists of the 
statements repeated each time while repeats. Because of this, it is possible that if the pretest Boolean expression 
does not evaluate to true then the code within the block may never be executed. Pre-test repetitions structures 
have their own flowchart pattern along with their own pseudo code and programming code format. Because of 
this, we will demonstrate both the pre-test and post-test repetition structures with their representative flowchart 
and pseudo code examples. 

Pre-Test Repetition Structures- Pre-test repetition structures allow the program to repeat through a block of 
statements only if the Boolean expression evaluates as true. The Boolean expression is evaluated before the loop 
is executed and it is possible that if the Boolean expression evaluates as false on the first pass, the loop logic might 
never be executed. 
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While (Country = "USA ") ^ 
usaCnt = usCnt + 1 

print "Country Count = " plus usaCount 



do 

usaCnt = usCnt + 1 

print "Country Count = " plus usaCount 
untH(CQuntry = "USA") 




Post Test 
Loop 



Figure 12:Pre-Test and Post -Test Loop Diagram 



FLOWCHARTS EXAMPLE 

The pre-test flowchart consists of a diamond symbol that represents the Boolean expression with two points of the 
diamond representing true and false. If the expression evaluates as false, the loop terminates and continues to the 
next logic step. If the expression evaluates as true, the logic steps included within the loop are executed. After 
these statements are executed the loop test is executed again to determine if future loops are required. 
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Figure 13:Pre-Test While Flowchart Example 

In this example, a variable named cnt is initialized to the value of zero. The while loop tests with its Boolean 
expression to see if the value of cnt is less than 11. On the first loop, the value of cnt is zero so the Boolean 
expression is true. It will then execute the true branch of the diamond symbol and print the contents of the cnt 
variable and then add one to the value of cnt. On the next pass of the loop, the cnt value is now 1 so the true 
branch Is executed again. It will continue until the value of cnt is 11 and at that point it fails the Boolean expression 
and continues to the final print statement. The output of this logic should print the numbers one through ten each 
on a separate line with a final print statement at the end displaying a message that the program is complete. 

COMMON REPETITION STRUCTURE FLOWCHARTING MISTAKES 

A common error made with repetition structure flowcharts is not returning the branch line back to a point above 
the decision symbol. This may appear to look okay at first glance. Many program languages may let you get away 
with one input instruction inside the loop as opposed to a single input outside the loop and another input within 
the loop but this violates the one input and output line on a control structure. When you are using a while loop to 
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capture and validate input you should set up and initial read outside of the loop for the first read and another 
input inside the loop for repeated inputs. Look at the following flowchart. 
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Figure 14: Example of a repetition structure that does not brancli bacl< to the decision synnbol. 



PSEUDO CODE EXAMPLE 

For our pseudo code example, we could borrow from the symbol text placed in our flowchart and simply reformat 
it for our pseudo code. The formatting, or I should say indenting, of repetition structures holds the same 
importance as was previously discussed with decision structures. The statements contained within the while block 
should be indented underneath the statement containing the while key word and the Boolean expression. 

cnt equals 
while cnt < 11 then 
print cnt 

cnt equals cnt + 1 
print "End of Program" 

cnt < 11 is the Boolean expression. As long as it remains true, the while will continue to loop. 

Key Concept: Infinite Loops - There is a situation that can exist within a repetition structure called an infinite loop. 
This occurs if the Boolean expression never becomes false. The program will continue to loop until the program is 
aborted or the PC is turned off. Under most circumstances, an infinite loop is a logic error. This is one of those 
errors that everyone makes ). Having an infinite loop occur in one of your career at least once (okay twice 
programs can more or less be considered "rites of passage." We all do it at least once. Making mistakes is 
inevitable but not making them a second time is what you should strive for. 

POST-TEST REPETITION STRUCTURES 

As mentioned earlier, while loops come in two varieties. One option tests entry into the loop and the other option 
tests at the conclusion of the loop. In this post- test repetition structure, since the Boolean expression is at the end 
of the loop, this loop will always be executed at least once. Depending on the evaluation of the Boolean expression 
at the end of the block, the loop may be executed again. 

Post-Test Repetition Structures: Similar to a pre-test structure except the Boolean expression is evaluated at the 
end of the loop after all of the loop statements have been executed. With post-test loops, the loop is always 
executed at least once. Future looping is predicated on the Boolean expression value at the end of the loop. If true, 
the repetition structure statements will be executed again. If false the program moves out of the loop and on to 
the next statement. 

FLOWCHARTS EXAMPLE 

Contrast the post-test repetition flowcharts with a pre-test repetition flowchart. You'll see that in the post-test 
chart, the logic steps included within the loop come before the Boolean expression and controls any additional 
looping. On the pre-test loop, the logic steps occur after the Boolean expression. The outcome of both of these 
flowcharts is the same. They will both print a number from one to nine on its own line concluding with a message 
that the program is complete. 
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Figure 15: A post-test repetition structure flow chart 



PSEUDO CODE EXAMPLE 



The pseudo code used for post-test repetition structures is slightly different than the pre-test. There are a number 
of ways to document the looping. One option is to continue using the while keyword except the while is now 
performed at the end of the loop instead of at the top. This is seen in the following example. 
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cnt equals 0 
Do 

print cnt 

cnt equals cnt + 1 
while cnt < 11 then 
print "End of Program" 

- This is a post test repetition structure that determines if the loop continues based on the decision made at the 
end of the loop. 

The until keyword can be used as a substitute for the while statement. In the example below I used to do keyword 
to mark the start of the loop and the until keyword to mark the end of loop. We find the Boolean expression at the 
end of the loop. Remember, pseudo code is non-standard so that keywords and how you describe your logic can 
vary. If you are using another programming language other than PYTHON, check you programming reference for 
how to implement repletion in your programs. 

cnt equals 0 
Do 

print cnt 

cnt equals cnt + 1 

until cnt < 11 then 
print 

- until is also a popular keyword to implement post test repetition structures. 



PYTHON TIP: Post-test looping has not been implemented in PYTHON. Repetition logic can be implemented as a 
pre-test while loop only. 



In Practice: Are You a Pre or Post Test Looper? - Hopefully, you have begun to see from the previous examples that 
it makes little difference whether you use a pre-test or post-test logic to perform repetition. One hint of this might 
have come from the fact that PYTHON does not support post-test looping. Even when both alternatives exist in a 
programming language, which is usually case, I find most programmers gravitate towards one format or the other. 
I am a pre-test looper. In other words when I construct my repetition logic, I will lean towards using pre-tests 
loops. In fact, the only time I work with post -test loops is when they've been coded by another programmer and I 
am maintaining their program. It is however still important to note the differences between both alternatives. 
With a pre-test loop, it is possible that if the Boolean expression is false the loops logic will never get executed. 
With a post test loop, it is important to remember that the code within the loop will always be executed at least 
once. 



REPETITION STRUCTURES WITH FOR LOOPS 

There is also a second form of repetition structure implemented in many languages called a for loop. The for loop 
is traditionally used when the logic needs to iterate through some number of repetitions. Iteration is typically 
triggered by a count value (also called iteration variable). For loops work exclusively with iteration whereas wliile 
looping can use iteration or a Boolean expression that can make entrance into the loop based on a logical 
operator. The difference is subtle but while loops traditionally are more flexible then for loops. That said, for loops 
are a very powerful tool to use with arrays (a topic covered later in the eBook) and we will revisit for loops again at 
that time. We will focus on While loops in this chapter. 
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Key Concept: Typically, you'll find that whatever can be done in a for loop can be done in equally as well with a 
while block. While blocks represent the most complete solution for implementing code repetition. For loops work 
best when the program needs to increment or decrement (iterate) some number of set repetitions. While loops 
can support iteration of can also support looping controlled with a Boolean expression that evaluates not only 
numbers but any valid Boolean expression. With a while statement, I can exit mile loop with a Boolean expression 
such as "City not Equal to Phoenix." This type of Boolean expression is not possible in a for loop where the Boolean 
expression is simply evaluating a variable which is incrementing or decrementing an iteration variable. 



In Practice: Repetition Structures used for decisions? - Repetition structures use a Boolean expression to control 
entry into the loop. Boolean expressions use logical operators to compare two values. The outcome is either true 
or false. The while loop Boolean expression is typically the same as the Boolean expression for an if statement. 
Because of this, you can use the Boolean expression as a decision structure governing entry into the loop. It is 
possible to place the input inside the loop and have it repeat until the input is correct. The pseudo code below 
demonstrates this. 



cost = -1 
while cost > 0 

cost equals input("Enter Product cost") 

if cost < 0 then 

print "Invalid Cost" 
print "Product Cost" plus cost 

- Here the Boolean expression does not use a counter but true logical expression. 

- Notice the nested decision structure inside the repetition structure. 

Cost is initialized to enter the loop the first time. If the input is greater than zero the loop is excited when the 
Boolean expression is tested again. If the input is less than zero, a message is displayed and the loop is executed 
again because cost is not greater than zero. 

USES OF REPETITION STRUCTURES: ACCUMULATION AND COUNTERS 

We have two common operations served by repetition structures. The first operation is counting. Counting is a 
very important operation in programming. You will count to perform calculations (i.e. averaging numbers) and 
count to determine if you need to keep on looping in a while block. Counting is accomplished in logic by defining a 
variable and adding or subtracting a value from the variable during each repetition loop. If you add to the counter 
on each loop, the counter value increases (incrementing). If we subtract on each loop, we count down 
(decrementing) with the counter. We can count by ones or by larger numbers. Here are some counting examples 
illustrated in pseudo code: 



count equals 0 
countDown equals 0 
countByFive equals 0 
One = 1 

While count <= 10 

count equals count + 1 
countDown equals countDown - One 
countByFive equals countByFive + 5 

Print count, countDown, countByFive 
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- Here we have a counter inside the while loop 

- Another counting example. This time incrementing by five on each loop. 



Counting: The counting activity in a program is accomplished by defining and initializing a variable and placing that 
variable inside a loop. With each iteration of the loop, a value is added to the counter to increment or a value is 
subtracted from the counter to decrement. 

Accumulating is also a popular operation used in program logic. With accumulation, and accumulator variable is 
designated to accumulate a number in an variable. The statements necessary to perform accumulation look very 
similar to the statements that count. Instead of incrementing a counter variable by a set number, we will be taking 
some value or identifier and add this to the accumulator variable on each repetition. The effect is that the 
accumulator variable grows (summarizes) on each pass of the loop. In the following pseudo code example, we use 
a counter and accumulator variables to calculate a test average of five test scores. 



count equals 0 
totScore equals 0 
score equals 0 
while count < 5 then 
Input score 

totScore equals totScore plus score 
count equals count plus 1 
print TotScore divided by Count 



- totScore is accumulating by taking its previous value and adding score to it on each loop. 

Accumulating: An accumulating operation is similar to counting except that instead of adding or subtracting the 
same number on each pass, accumulating adds or subtracts an identifier or numeric literal value to a variable on 
each pass. The value accumulated could be the same value on each pass or a different value. 

Status Checl< 

How many times will the code inside the while block be executed with a post-test while loop? 

What is the difference between counting and accumulating? 

Can a for loop structure be simulated with a while repetition structure? 

NESTING REPETITION STRUCTURES 

Just as with decisions structures, nesting repetition structures is also an important option in designing program 
logic. Like with nested decision structures, a while loop may have many other while loops contained within it. I 
have included a simple example of nested while loops but we will see others as we move through the eBook. 
Nested while loops are especially effective and processing multi-dimensional arrays. Arrays are a specific type of 
data structure that hold collections of identifiers. We will cover the topic of arrays later the eBook. 
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Nested If 
Statement 




If qty >= 100 then 

IfstatB = "AZ" 

discount equals .04 

«lse 

while ttemCnt <10 \ 

discount equals .01 ^ 
ltemCnt= ItemCnt + 1 



Nested 
While 
Statement 



Figure 16: Nested Decision and repetition structures 

Here is a pseudo code example of a nested while loop: 

outerCount equals 1 
innerCount equals 1 

while outerCount < 4 then 

print "Outer Loop Count = " plus outerCount 
outerCount equals outerCount plus 1 

while innerCount < 4 then 

print "Inner Loop Count " plus innerCount 
innerCount plus 1 

print " " 

print "End of Program 

The results of the logic when processed in a program would look like the following: 
Outer Loop Count 1 
Inner Loop Count 1 
Inner Loop Count 2 
Inner Loop Count 3 

Outer Loop Count 2 
Inner Loop Count 1 
Inner Loop Count 2 
Inner Loop Count 3 
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Outer Loop Count 3 



Inner Loop Count 1 
Inner Loop Count 2 
Inner Loop Count 3 

- Outer repetition structure implemented as a while loop 

- Inner repetition structure implemented as a nested loop 

Do you understand how this display was generated? Does the nesting of the while loops make sense? Do you see 
how the outside while loop iterates once and then the inner loop iterates three times for each outside loop. We 
then hit the second iteration of the outer loop with the inner loop executing three times again. This is how a 
nested loop with two while blocks would execute. Can you visualize the effects of a nested repetition structure 
with three while loops? 

CASE STUDY - CACTUS BOOKS AND TAPES 



The Chavez sisters are happy with the progress made so far and are anxious to see more of the on-line book 
reservation logic implemented. You have two programs that you'll need to work on in this case study. The first 
program will be finishing up some work started in chapter three and creation of a new program that will involve 
collecting customer input for order processing. We will start with finishing up on the case study first identified in 
chapter three in part A and move to the new program in part B. 



PART A 

Let's look over a transcript of the last session you had with the sisters concerning the customer discount 
calculation. 

They have been thinking about developing a loyalty plan for frequent customers loyal to the store. The calculation 
needs to be modified to give a loyalty discount (1.5 percent) if they enter their customer number. In addition, if 
they have purchased more than three books in the current month, they are given another $10 dollars off their 
order. The $10 dollars is applied after all other discounts." 

You'll need to modify the pseudo code from the chapter three's case study to accommodate two new decision 
structures which need to be included in the logic. The first decision structure uses an if statement to determine if 
the person is a loyalty customer. If you remember from last chapter, a loyalty customer is a person who frequently 
shops at Cactus Books and Tapes. The second decision structure is also implemented as an if statement and 
implements quantity discount logic that the customer is entitled to if they purchased three or more books in this 
order. 



PSEUDO CODE LOGIC SOLUTION 



Start 

Input WSCost 
markup equals 1.25 
handling equals 5 
loyaltyBonus equals 0 
quantityDiscount equals 0 
Input custLoyalStatus 
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If custLoyalStatus = true then 

loyaltyBonus equals 1.5 percent 
Input Qty 
if Qty >=3then 

quantityDiscount equals 10 
SubTotal equals WSCost times markup plus handling 
custDiscount equals subTotal times loyaltyBonus less 10 
custCost = subTotal less custDiscount 
Print custCost 
End 



PART B 

You are now ready to work on other logic necessary to process the book order. In this second program, you'll want 
to create logic the ask the customer for their name, the number of books purchased and then loop through that 
logic to gather information on title, price and quantity. The program will and by displaying the total book quantity 
and the total order amount purchased in this customer order. You have been asked to implement a "flag" value to 
determine when the customer is finished. The "flag" value will be used in the while statement Boolean expression 
to finish up with collecting input and move on to the next section of the program. 

Input "Enter Customer Name" name 

Input "Enter Book Name or QQ to quit" bookName 

while bookName <> "QQ" then 

Input "Enter Book Price" price 

count equals count + 1 

totPrice equals totPrice + price 

Input "Enter Book Name or QQ to quit" bookName 
print "Total Price" plus totPrice 
print "Count " plus count 

- Here I have used QQ as a sentinel value to trigger the end of the loop and also the end of input. A while loop 
provides this type of flexibility. Something that could not be done with a for loop without changing the logic. 

In this pseudo code, you will see the while loop controls the number of times the user is prompted for book name 
and price. Also, the while block has both accumulating in counting operations that will be used in the printed 
summary at the end of this customer's order 

STRUCTURES USING COMPOUND OPERATORS 

Earlier in the chapter, we covered compound operators which are used to join logical expressions. Compound 
operators are important in both decision and repetition structures. They add flexibility and power to our 
structures. Different languages implement compound structures differently so you will want to refer to your 
programming reference for compound operator syntax. 

The two most commonly used compound operators are and and or. You can easily join two Boolean expressions 
but as you join three and four you have to be conscious of operator precedence and its effects on evaluating the 
entire collection of expressions. Logic errors are common with this type of statement. Operator precedence will 
have you evaluating each individual expression first and then each expression with each other from left to right 
and so on. To illustrate how to properly evaluate compound operators, I have included the following pseudo code 
example: 
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a = 1 
b = 2 
c = 3 



if (a = 2) or (b > 1) and (c = a) 

The first expression, (a = 2), will evaluate as false. The second expression, (b > 1), will evaluate as true and the third 
expression, (c = a), will evaluate as false. The compound operator joins expression one and expression two first. 
Since expression one is false and expression two is true and they are joined with an or, only one side has to be true 
for the whole expression to be true. This is the case so this first compound expression evaluates as true. The third 
expression is false and it is joined to with the first two expressions with an and. Since one side is true and one side 
is false, then the entire expression finally evaluates as false. 

COMPOUND OPERATORS IN DECISION STRUCTURES 

Here is an example of how a compound operator will work with a decision structure, qty > 4 will be evaluated first 
and then qty < 10 next. If both evaluate as true the entire expression is true. In this case, the qty must be between 
5 and 9 to call the true branch and anything else to call the false branch. 

if (qty > 4) and (qty < 10) 

subTotal equals extCost minus (extCost times DISCOS) 

else 

subtotal equals extCost 
COMPOUND OPERATORS IN REPETITION STRUCTURES 

Here we have a similar scenario where two Boolean expressions are used in a repetition structure to determine if 
the looping will continue. 

while (qty > 0) or (partCode = "A") 

extCost equals cost times partCodeAdjust 

For this loop to continue into the quantity must be greater than 0 and the partCode must be equal to the literal 
"A". 



PUTTING IT TO USE 



The intent of this section is to introduce the new programmer to standards and techniques frequently used by 
professional programmers. Topics in this section relate to concepts introduced in the chapter but with a more 
vocational or occupational focus for students considering a career in programming. 



Best Practices: Program Source Code Comments - In previous chapters, I talked about documenting your logic 
within your program as a program comment. The program comment is a non executable line which is visible to 
those editing the program but invisible to the users who are executing it. As a rule, I have a requirement in my 
programming classes that every line of code of the program is commented. Those students who have had previous 
program experience will be the first to remind me that this rule is a little extreme. There are no set rules on what 
or how much program commenting should be done inside a program. When asked how much is enough? I will 
quite often give the answer that you should comment any logic in your program that might be confusing or difficult 
for another programmer to understand. I also say all structures and calculations should be commented. 
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I specifically identify programming structures as a good place to think about adding program comments. Reflecting 
about what we've learned so far, certainly decision and repetition structures have been the most complicated 
mechanism used in our logic and programming so far. It is highly likely that these structures will be included in the 
more complex parts of your logic and therefore make excellent candidates for program comments. It has been my 
experience that it is better to error with too many comments that not enough. In other words, if you have any 
thoughts at all about a part of your program being complicated, then comment it! 

It is also common practice to include a few lines of comments at the beginning of your program that identify the 
name of the program, the person who wrote the program, a description of the program. Any updates made to the 
program after the original coding should include the date and initials of the person who modified the program 
along with a short description of what they changed. This acts as a history of the program and creates a timeline 
and blueprint for how this program was developed and updated. 

SOURCE CODE FORMATTING 

It has been mentioned already about the importance of properly indenting decision and repetition structures. I 
would like to go one step further and suggest that even though the compiler and interpreter may not care how you 
indent your source code, failure to use good standardized source code formatting techniques will have a very 
negative effect on your work when reviewed by other programmers. Think of it like this. Suppose you are editing a 
five page term paper. You can hand in the paper neatly handwritten on ruled paper or you can print it out double 
spaced with a letter quality printer. Which of these documents will be the easiest to read? Which of these 
documents will look the most professional? Style points may not count in programming but formatting of code is 
an indicator of the programmer's professionalism and discipline. 

Some things to remember when you're formatting your source code: 

• All branches on decision structures should be indented the same number of spaces. 

• Nested if statements should first line up with other branch statements with their branches indented the 
same number of spaces. 

• Separate structures with a blank line in your source code. Cramming all the lines together with no visual 
breaks makes sections of the code more difficult to find. A blank line placed in front of the structure 
isolates it from other program code and makes a logic user to find. 

• A program comment placed in front of the structure should give general information on what the 
structure is to accomplish. Beyond that specific program line comments can be placed to the right of the 
statement or on the previous line. 

Below are two more sophisticated PYTHON programs with a number of structures. One with comments inserted 
and lines formatted and one without. Which one would you rather work on? 

Uncommented and unformatted 
totalCost = 1 
totalSale = 0 
extCost = 0 
subTotal = 0 
qty = 0 

totAIISales = 0 
DISCIO = .10 
DISC05 = .05 
SALESTAX = .08 
while qty != -1: 

qty = input("Enter Quantity or -1 to quit >> ") 
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if qly > 0 and qty < 100: 

extCost = totalCost * qty 

if qty > 4 and qty < 10: 

subTotal = extCost - (extCost * DISCOS) 

elif qty > 10: 

subTotal = extCost - (extCost * DISCOS) 
else: 

subTotal = extCost 

totalSale = subTotal - (subTotal * SALESTAX) 
totAIISales = totAIISales + totalSale 
print "Total Sale plus tax is :", totalSale 
print "Total All Sales : " , totAIISales 



COMMENTED AND FORMATTED 

Comments marked with # (pound) sign. 

#program variables 

totalCost = 1 

totalSale = 0 

extCost = 0 

subTotal = 0 

qty = 0 

totAIISales = 0 
DISCIO = .10 
DISCOS = .OS 
SALESTAX = .08 

#main logic starts here 

#loop while qty is not equal to -1 

while qty != -1: 

#prompt for quantity 

qty = input("Enter Quantity or -1 to quit >> ") 

#if qty is greater than zero and qty is less than 100 

if qty > 0 and qty < 100: 

#ext cost equals total cost time qty 

extCost = totalCost * qty 
#if qty is great then 4 and qty is less than 10 

if qty > 4 and qty < 10: 

#sub total equals extCost minus extCost times DiscOS 
subTotal = extCost - (extCost * DISCOS) 
#else if qty great than 10 
elif qty > 10: 

#subtotal equals extCost minux extCost times DiscOS 
subTotal = extCost - (extCost * DISCOS) 
#else - outer branch is false 
else: 

#subTotal equals extCost 
subTotal = extCost 
#finish up processing 

#totalSale equals subTotal minus subtotal times salestax constant 
#totalAIISales equals totAIISales plus totalSale 
totalSale = subTotal - (subTotal * SALESTAX) 
totAIISales = totAIISales + totalSale 
#print total sale 
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print "Total Sale plus tax is :", totalSale 
print "Total All Sales : " , totMISales 



Although they both produce the same results, I don't think there's any question as to which program is the easiest 
to maintain. Certainly, the second example that has blank lines (also called white space) is visually easier to follow. 
The comments make the program logic easier to understand as it moves through different logic twists and turns. 
This makes future changes easier to understand. 



CHAPTER REVIEW 



Chapter summary, highlights, key terms, short answer questions, quizzes and case studies to reinforce topics 
covered in this chapter. 

CHAPTER SUMMARY 



After finishing this chapter you should understand and in some cases, demonstrate the following topics: 

• Explain the importance of structured programming techniques in creating programs. 

o Control structures allow programmers to build complex applications by providing decision and 
repetition support. 

o When using flowcharts to create structured programming logic designs, each symbol should have 
one input and one output line, with each symbol containing a short description of the purpose of 
the symbol and making sure no lines in the diagram cross. 

o Pseudo code has strict requirements regarding the indenting of statements that fall under the 
true and false branch of the Boolean expression. 

o When a structure calls another structure because of the evaluation of the Boolean expression, 
the called structure is called a nested structure. All of the control structures can be nest under 
any of the other control structures. 

• Explain the importance if controls structures to logic modeling and programming. 

o Programs make decisions in logic with decision structures. Decision structures like the if 
statement allow a Boolean expression to use logical operators to return a true or false outcome. 
Once the decision outcome is determined, the program can branch to a series of instructions 
created for that outcome. 

• Define and implement sequence, decision and repetition structures with flowchart and pseudo code 

o Sequence control structures are the simplest of control structures but the most common. 
Sequence structures hold statements and expressions that constitute most of the instructions 
sent to the computer. 

o Decision structures provide decision support for our logic and programs. Through the 
implementation of if statements, a logic decision has a true or false outcome. The decision 
structure is implemented with a Boolean expression that evaluates as true or false. 

o Decision structures may be nested. This means a branch of a decision structure can contain a 
new decisions structure. 

o A decision structure must a true outcome and can optionally contain a false outcome. 
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o Repetition structures are very versatile and can be used to repeat blocks of code or as a 
mechanism for validating input. Repetition structures simplify logic that could otherwise need to 
contain many more repeated logic statements. 

o Repetition structures can be designed with a Boolean expression at the start of the while block or 
the end of the while block. Each while loop will work equally as well but the pre-test look may 
not execute the loop logic unless the Boolean expression evaluates as true and the post-test loop 
would execute the logic at least once and additional loops if the Boolean expression evaluates as 
true. 

o The repetition structure can be used for counting and accumulating numbers if the counting and 
accumulating variable is contained within the loop. Counting will increment or decrement the 
same on each loop and accumulating will sum a number into a variable for each loop. 

CHAPTER KEY TERMS 

Accumulating 
Branch 

Compound Operators 
Control Structures 
Counting 

Decision Structures 
Nesting Decision Structures 
Nesting Repetition Structures 
Post Test Repetition Structure 
Pretest Repetition Structures 
Program Comment 
Repetition Structures 
Sequence Structures 
Single Branch If Structures 
Source Code Formatting 
Structured Programming 
Two Branch Decision Structures 
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PART 2 INTRODUCTION TO STRUCTURED PROGRAMMING 



CHAPTER 5 FUNDAMENTALS OF MODULARIZATION 



IN THIS CHAPTER, YOU WILL LEARN HOW TO: 



• Define procedural programming techniques and its implications on logic design 

• Define modularization and describe its benefits 

• Describe identifier and module scope and the implications of global, local and block scope designations 

• Describe the process of identifying code to modularize 

• Recognize the importance of module abstraction and reuse 

• Demonstrate how called modules can accept parameters and return a value 

• Recognize how different programming languages implement modules 



PROCEDURAL PROGRAMMING TECHNIQUES 



We started in our first three chapters taking baby steps with logic models and simple programs. In our last chapter, 
the pace quickened as we learned about control structures and how to add complex logic to our programs that in 
previous chapters we had to avoid. In this chapter, we add the organization of procedural programming techniques 
to design more complex logic models and programs with the modular approach characterized by procedural 
programming. 

We will begin to incorporate procedural programming techniques into our logic design. Procedural programming is 
characterized as a problem solving technique that follows a "divide and conquer" approach. What is meant by 
"divide and conquer" is a stepwise approach that takes a complex problem and break it down into smaller 
subtasks. The pieces can communicate with each other so the computer program becomes a series of subtasks 
that make up the whole. There is quite a bit of evidence that suggests that this approach of problem solving can be 
very effective in designing complex solutions. 

Procedural programming gets its name from its dependence on procedures (or blocks of logic) that create 
statements to perform one subtask. A program is a collection of many sub tasks or procedures that together fulfill 
the requirements behind the program. Just like control structures, procedures are found in most programming 
languages. Whereas control structures are typically implemented with if and while statements, procedures come 
by many names (like function, method, subroutine and procedure). Even if the name is different, all of these terms 
refer to a procedure that represents a subtask of the program. 
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A procedure is very similar to tlie code block used by control structures. The difference is that a procedure typically 
contains many structures and statements and is called out in program logic to be run as a sub task. 



Key Concept: The procedure or module is executed when it is called in the program. When called, all of the 
statements in the module are executed and then control is return back to the call point where execution is now 
focused on the next statement. If the module returns a value, then the statement that called the module must 
receive that value and use that value in the calling statement. 



Let's choose a non programming example to illustrate procedural designs. Do you suppose that the design team 
who constructed the space shuttle sat down in front of the drawing board and designed all of the systems from 
start to finish? Would they have done this without ever trying to break down shuttle functions or operations into 
smaller pieces? I would suggest that the answer is no and that the space shuttle, although it had a design that 
joined all the systems, most of the space shuttle was designed in pieces. One piece or sub task might have been 
the launch system. Other pieces might have been the communications, reentry, cooling and heating and crew 
quarters. One other piece or subsystem might have been the arm used in the cargo bay. It is likely that each of the 
components on the space shuttle was given to a different group of engineers to design with one group focusing on 
merging all of the components. Now, as I am sure you can imagine, I had no part in the design of the space shuttle 
but I have been involved with development of several very complex systems. What characterized my involvement 
in the design of these systems were the technique of modularization and the process of taking the larger problem 
and breaking in down into smaller pieces. 



Procedural Programming: Procedural programming is build around the concept of developing programs based on 
sub tasks (also known as modules of code). The modules are called and connected by a single parent module that 
coordinates all of the modules into a working solution. Procedural programming gets its name from procedures. A 
procedure is a subtask that is implemented in programming languages under a variety of language specific names 
(i.e. functions, procedures, methods, sub routines, etc.) 



MODULARIZATION DEFINED 

Modularization is the process programmers use to break up complex programs into smaller more manageable 
procedures. These procedures are also referred to as modules. To borrow an earlier example from chapter four, I 
spoke of a procedure to calculate sales tax as an example of statements in a program that could be bundled 
together and represent a sub task of the entire program. If the program I am writing needs to calculate the cost of 
a customer order, if I break off into a procedure the sales tax processing and possibly the logic for quantity 
discounts, I can concentrate on the design and testing of each module or subtask and help to make the program 
logic more effective. The "divide and conquer" approach will allow me to work on each piece individually and later 
connect those pieces for the finished product. Aside from the obvious benefits of reducing program complexity, 
modularization helps in many other ways. 



Modularization: Modularization defines the process of reviewing program logic to identify program subtasks. 
When we divide the program up into subtasks we make the design of logic simpler and more accurate. The logic 
contained within the subtasks is stored as modules. These modules are combined with statements to make up the 
program. 



Modules: A module is a block of code that represents a program subtask. This subtask is a standalone piece of 
code that performs part of the programs solution but also could stand by itself and potentially be used in other 
programs. For example, I could create a sub-task that calculates the sales tax of a purchase. It is only part of the 



Procedural Programming Techniques | http://laptoppress.garymarrer.com 



logic but is required for the final solution. Because it can stand alone, it could be reused in other programs that 
have a similar requirement (i.e. other programs also would need to calculate sales tax). 



BENEFITS OF MODULARIZATION 



Simplifying programs is just one of the benefits of modularization. It may be the most obvious and also one of the 
more important benefits but it is valuable in other ways. Modularization helps us as programmers by providing 
improved organization to our logic and programs. 

BENEFITS CODE REUSE 

In regards to modules, there are two situations where a module could be a used in the development of programs. 
The most common application of code reuse is the use of modules across different programs. If the module is 
designed to stand alone and be independent of the rest of the program, there is no reason why a module that's 
developed for one program might not work just as well in another. To use the example of sales tax, for company 
that does a retail business there will be many opportunities for the sales tax module to be used in programs. The 
program might be used at the register or might be used to print a hard copy invoice to a customer. In its simplest 
form, module reuse can be simply copying source code from one program to another. This can be dangerous since 
a programmer unaware that the procedure is reused could change the code so that it is different than the original 
copy. This could create a main its problem on future updates. Many languages allow for modules to be compiled to 
the source code is hidden but still the logic is available via programmer built interfaces to the module. 



Logic Tip: Procedures, subtasks and modules all equate to the same thing. In each case, they are terms used to 
indicate a collection of statements and structures that represent some subtask of the entire program. This eBook 
will use modules most of the time but subtask and procedure will also appear in the text from time to time. 



A reused code module, if developed by an experienced programmer who has experience designing modules that 
are of high quality and performance, can be a tremendous asset to an organization. Their code can be used by 
everyone in the organization to save time. For the new programmers who are still learning design, having a library 
of tested and well designed modules make their work higher quality and teaches them the characteristics of well 
written code modules. 



Bacl<ground Information: An economic case for code reuse - Programming code reuse has become a very 
fashionable subject in program design. As more and more languages support object orientated programming, 
reuse is becoming more and more a part of the programmers design alternatives. Aside from design benefits, there 
are also economic reasons for reusing code. Most programming departments have one thing in common. That one 
thing is the inability to keep up with a number of programming requests that come in every day. Providing ways of 
making programmers more productive is critical to most organizations. Using design techniques which provide for 
code reuse is one way of reducing the amount of time needed to develop software. After all, time is money and 
saving time is saving money. We will see code reuse as an advantage in modularization and also we will see this 
highlighted again when we discuss object orientated programming. 



A SIMPLE PSEUDO CODE EXAMPLE OF MODULARIZATION 

The following code snippet demonstrates how a program can have its logic organized into sub-tasks or module. 
First we have a pseudo code program without modularization. 



start 

input "enter amount" 
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if countryCode = "Maricopa" tlien 
taxRate equals .086 

else 

taxRate equals .075 
print "Sales Tax = " taxRate times amount 

end 

After modularization the same program would now look like the following, 
start 

input "enter amount" 

call salesTaxModuleProcO 

print "Sales Tax = " taxRate times amount 

SalesTaxModuleProcO 

if countryCode = "Maricopa" then 

taxRate equals .086 

else 

taxRate equals .075 

return 

end 

- The call statement tells the program to look for the salesTaxModuleProc. 

- Here the salesTaxModuleProc is written in our program and the statements for sales tax have been placed 
together in this module 

- The return keyword signals the program that the module is done and to return to the next line in the program 
(i.e. the print statement). 

A second form of reusability that can benefit the program includes recalling (a slightly different kind of reuse) the 
module from within the program itself. In the case of sales tax, it is highly possible that sales tax pay will need to 
be calculated several times in the same program. You have some options. You can either create the statements 
necessary for sales tax and place them in a module or duplicate the statements every time there needed within the 
program. The more efficient alternative would be to create a module and call the module whenever the sales tax 
calculation was needed. An immediate advantage here is program maintenance. If the code and module need to 
be changed for any reason, the change only needs to occur in one location) the module) and any place that module 
was called will automatically a pickup the code change. 



Programming Tip: Many programming languages compile modules so that the source code (and therefore logic) is 
not visible to the programmer. This means you are using a module that you are trusting works correctly but do not 
know how it accomplishes its task. This hidden logic can be understood if you understand the power of abstraction 
in program design. 



ABSTRACTION 

Modularization can occur in both logic models and in programming. For logic models, the modules are built in 
either pseudo code or flow charts. All of the logic is "English" like and easy to read. In programming this is not 
always the case. Many reusable code modules are compiled into machine readable formats with only helps files to 
instruct the programmer how to implement the module. The code behind the module is not visible to the 
programmer as source code. A couple examples of this "hidden source" code occurs in the Java application 
programming interface and the Microsoft .Net Framework. Each contains thousands of reusable code modules but 
neither actually shows the programming statements behind them. 
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The concept of compiled reusable modules Is defined as abstraction. Abstraction is one of the foundation points 
for modularization and object oriented programming. Abstraction is discussed frequently in programming but it 
also has a larger meaning. Abstraction also is used to describe how humans interact with "things" (devices, 
machines, equipment, etc.) in our environment. Abstraction says that to use something we only need to know how 
to communicate with it. Communication requires that we are able to send inputs and that we have some idea of 
what we will receive as outputs. As humans, we use abstraction everyday as we interact with things in our world. It 
is from this application in humans that the concept was carried over to computer programming. 



Abstraction: Abstraction is a process where logic or program details are not available to the programmer. Rather 
than seeing things in detail you are shown an abstraction or only what is necessary to communicate and use the 
module. This information includes the modules inputs and what is returned as outputs. 



My favorite example to illustrate abstraction is the data projector mounted to the ceiling of my programming 
classes. The data projector allows me to take Power Point slides and project them on a screen in the front the 
room. I use the following analogy to explain how abstraction eliminates the need to know all of the details. I asked 
the students if they know how to use the data projector? Many of them shake their head yes. I ask them do they 
know what the wiring schematic looks like for the electronics or what plastic polymer was used to make the data 
projector case? Do they know what kind of glass used in the lens? I get some very strange looks but then I explain 
to them that what we really need to know is how to set the data projector messages and understand what outputs 
it will in turn deliver back to us. We used the data viewer with knowing the details. As humans, we are very 
comfortable using abstraction. 

I think most of us would instinctively use the data projector as an abstract thing. Using abstraction, we would 
intuitively know that we need to plug the graphics cable into the computer and the power cord into the wall 
socket. We would need to push the on button and adjust the volume and focus so that the picture is displayed 
clearly. We do not need to know any of the other details that went into the making of the data viewer or what is 
happening inside the data viewer to make it work correctly. Most of the things we use daily, we interface with by 
only knowing the inputs and the outputs. The process in the middle is something which we ignore. This is 
abstraction. 



Related Subject: Black boxing it! - There's an expression which is used in the world of engineering and also the 
world of computer programming called "black box." When we refer to something as a black box, we are saying 
that we acknowledge that a device or program is instrumental to our solution but we have chosen to ignore the 
details (like the data projector). We will assume that the outcome of the black box step is predictable and 
consistent even if we do not know what it looks like. The term is really talking about abstraction and 
modularization where we identify our problem as a series of subtasks and acknowledge that some of these 
subtasks are things we do not need to know about or understand to still come up with a solution. 



BENEFITS: SPLITTING DEVELOPMENT OF PROGRAMS 



Dividing programs into subtasks via modularization can be done at various levels of detail. In other words, 
modularization can take place at the program level and modularization can also take place at the system level. For 
example, you are one programmer of many involved with the development of a general ledger accounting system. 
Since a system can be broken down into smaller pieces, your responsibility might be the program using in creating 
general ledger reports. Another programmer on your team may be responsible for creating the programs to back 
up the general ledger data files. Modularization allows more than one programmer to work on a project at one 
time. We are focusing on modularization at the program level in this class but breaking down problems into 
smaller pieces can take place at many levels. 

In addition to allowing more than one programmer to work on a system at one time, modularization also allows 
development of new programs to be split in such a way that the different pieces of the program can be developed 
independent of one another. For example, within your program you may have identified twenty modules. Since 
the modules stand independent of one another and of the program, it is possible to work on that one module, 
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complete it and then pick any other module and the sequence and development. Each module can independently 
be designed and tested. Later when all the modules are complete, they can be reassembled with the rest of the 
programs statements for the final solution. 

Status Check 

What is meant when we say to "divide and conquer" when solving a problem? 
How is using computer hardware an example of abstraction? 
How does modularization promote logic/code reuse? 

A PROGRAM BEFORE AND AFTER MODULARIZATION 

The process of modularization requires that we include an extra step in the logic design process to isolate sections 
of logic which can standalone as subtasks of the entire program. I will choose an example that I've already 
referenced in the book and one which would be familiar to all of us. We are writing logic for a program which will 
calculate the sale of an item at a retail establishment like Cactus Books and Tapes. For purposes of our instruction, 
I will simplify the program from what you might find implemented at your local bookstore. We're not trying to 
avoid the hard parts but want to concentrate on just modularization in this example. 



Key Concept: When we are modularizing a program we are in effect providing improved organization of our logic 
or programming source code. To illustrate, think of your city phone book sorted in alphabetical order with a 
cardboard tab placed at the start of each new letter and the alphabet. Now think of a telephone book that is only 
sorted in alphabetical order. Which of the two phone books will it be easier to find information in? Declaring 
modules to better organize your code in your program is a lot like adding cardboard tabs to the letters of the 
alphabet in a phone book. The end result is a program which is easier to maintain and understand because the 
modularization has made it a better organized solution. 



When you purchase a book at the bookstore, the book is taken by the cashier and keyed or scanned into the 
register to calculate the cost of the sale. For most book stores, there are typically discount cards which give the 
customer a discount after purchasing so many books. If the discount applies, the discount percentage is taken off 
the cost of the books. The last part of the transaction involves calculating the sales tax. The sales calculation is 
completed and you'll now know how much to pay the cashier for your purchase. In this example, we will take the 
discount off of the price before we apply the sales tax. I will show both the flowchart and pseudo code for this 
application so that you can see the flow of the logic. 
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start 



start 

input items cost into cnst 

input distxjunt card nunriber into disoountNumber 

If disoOuntNumber exists tlier 

T 



bcxikDisc equals cosl times .10 
totCost equals cost - booM^isc 



else 



toCcist equals cost 




input Items cosi into cost 

input ctiscount c^nd number into 
disoourrtN umber 

if discounlNumtier exists then 

call calcDiscountO 

else 

toCosl equals cosl 

call calcSalesTaxO 

print lotCost 
end 



calcDi$COunl() 

tiookDtsc equals oast limes .10 
totCost equals cost - booltDisc 

return 



calcSaiesTaxO 

input State Code inio slateCode 
if stateCode = *AZ" then 



totCost equals totCost limes 1 .08 



JEtUUL 



Figure 1: Flowchart of Sales Purchase 



PSEUDO CODE SALES PURCHASE LOGIC 
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start 

input items cost into cost 

input discount card number into discountNumber 
if discountNumber exists then 

bool<Disc equals cost times .10 

totCost equals cost - bookDisc 

else 

totCost equals cost 
input State Code into stateCode 
if StateCode = "AZ" then 

totCost equals totCost times 1.08 
print totCost 
end 

This example is a short one but there's enough code here to perform modularization. Let's look at the preceding 
pseudo code. After looking closely at the logic, we can see three subtasks developing that when added together 
perform the sales purchased logic. Inside the logic, we can identify logic steps related to the application and 
calculation of a sales discount. We can also see inside the pseudo code, the logic statements that pertain to the 
calculation of sales tax for Arizona residents. Beyond that both of these sub-tasks work together as part of the 
larger application involved with processing the sales purchase. Sales purchase is the program that controls the 
logic and calls the two sub-process sees for discount and sales tax at the appropriate time and the program. 

Once the subtasks are identified they can be named in segregated inside their own code block or drawing in a 
flowchart. The module names should reflect the function of the module and use camel casing if the module has 
more than one word in the module name. In this example, I have used calcDiscount() and calcSalesTax() 
respectively to identify my two modules. Both of these names have trailing left and right parenthesis included as 
part of the name. These parentheses will be explained later in the chapter but for now include these as part of the 
module header. 

MODULES IN A FLOWCHART 

We can now explore how the flowchart is changed after modularization has been performed. We now see the 
flowchart that rather than having one chart including all the logic steps in the program, we now have one main 
program which calls to modules. The two modules are also drawn with flow chart symbols and are shown on the 
same page. The symbols and structures used for the modules are the same as the symbols and structures used in 
earlier programs. If you look carefully at the flowchart diagram, after modularization you'll see some changes in 
some of the labeling. For the two modules, you will see that instead of a start and stop a label on the terminator 
symbol, you will instead see the start symbol indicating the name of the module (again you will see the parenthesis 
next to the name) and the ending terminator symbol labeled with the word return. 



Procedural Programming Techniques | http://laptoppress.garymarrer.com 




Figure 2: Sample start and stop symbols for modules 



After you have identified symbols as candidates for modules, you would remove those symbols from the main 
flowchart and use them as the starting point for your module flowchart. Where the statements are removed you 
would insert a new module symbol that consists of a rectangle that has two lines drawn across the top and bottom 
or down the sides of the rectangle thus making them different than our sequence symbols, inside the module 
symbol would be the module name. 
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Symbols used to indicate a module call 
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Figure 3: Module flowchart symbols 



Modules are typically called from the main program or called from other modules (yes, modules can be nested just 
like structures). When you call a module, execution moves to the module and the statements are executed just as 
any flowchart except at the conclusion of the module diagram the return label on the terminator indicates that 
execution control returns to the calling program (or module). 



Tip Logic: Calling modules is a lot like clicking a hyperlink on a web page. When you click on the hyperlink you 
temporarily change focus to a new page and then if you click on the return button focus goes back to the original 
page. Modules work in much the same fashion. They are called from the main program and when they finish 
executing their logic, they return to the call point. 
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Figure 4: Before Modularization 
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Figure 5: Flow chart after modularization was performed 
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MODULES IN PSEUDO CODE 



The process of changing a pseudo code program into one that contains modules is similar to that of flowcharts. 
The process of isolating subtasl<s still needs to be performed with pseudo code. The rules and considerations for 
breaking the program up into pieces still apply with pseudo code. The only difference from flowcharts is rather 
than using symbols, we now use logic statements. When the module is called for execution you'll need a verb like 
call or perform to signal the pseudo code to find the code module and begin processing the logic steps within that 
module. At the end of the module, you'll see a return statement to redirect execution back to the statement below 
the calling statement. Below, I have an example of pseudo code which calls modules as part of the logic. This is the 
same program we just put into a flowchart. 

Pseudo code sales purchase logic with modularization 
start 

input items cost into cost 

input discount card number into discountNumber 
if discountNumber exists then 
call calcDiscountO 

else 

totCost equals cost 
call calcSalesTaxO 
print totCost 
end 

calcDiscountO 

bookDisc equals cost times .10 
totCost equals cost - bookDisc 

retu rn 

calcSalesTaxO 

input State Code into stateCode 
if StateCode = "AZ" then 

totCost equals totCost times 1.08 

return 

- The calcDiscountO represents the sub task that calculates the discount. This standalone module could easily be 
cut and pasted in to another pseudo code program. 

This block of code passes the test qualifying it as a module. 

- calcSalesTaxO also qualifies as a module. Notice that modules can have control structures and these structures 
can be nested. Notice how this code was taken almost statement by statement from the original pseudo code. 
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start 



start 

input items cost into cnst 

input distxjunt card nunriber into disoountNumber 

If disoOuntNumber exists tlier 

T 



bcxikDisc equals cosl times .10 
totCost equals cost - booM^isc 



else 



toCcist equals cost 




input Items cosi into cost 

input ctiscount c^nd number into 
disoourrtN umber 

if discounlNumtier exists then 

call calcDiscountO 

else 

toCosl equals cosl 

call calcSalesTaxO 

print lotCost 
end 



calcDi$COunl() 

tiookDtsc equals oast limes .10 
totCost equals cost - booltDisc 

return 



calcSaiesTaxO 

input State Code inio slateCode 
if stateCode = *AZ" then 



totCost equals totCost times 1 .08 



JEtUUL 



Figure 6: Modularization overview graphic 



Logic Tip: The example above has the pseudo code start and end keyword added to the logic. I have omitted these 
in many examples because it is only seen in complete programs and not the code snippets found in many of the 
eBook examples. This is significant because you will see that the modules are outside the main logic block do not 
have start and end keywords. The main logic block (also called the main module), contains the logic which controls 
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the sequence of statements and modules necessary to implement the solution. The modules by themselves 
contain only the logic of the subtask they are associated with. The main module that controls the program will 
always have a start and end label. 

The process of modularization concerns how to best logically break up the program into subtasks. In my design, I 
made a decision to include all the logic for processing State Code inside one module called calcSalesTax(). I also 
chose to keep part of the discount logic in the main program and implement actual calculation within the module. 
An argument could be made to include the entire discount logic within the calcDiscount() module like was done 
with calcSalesTax(). This design would have been perfectly acceptable. We will look at some criteria you may want 
to use in determining what to modularize but as with many things in programming design, it is largely reflective of 
how you want the logic statements to interact and what is resuable. When the computer compiles or interprets 
the statements, it will not care if there are modules or not. It will run equally the same with no benefit such as 
increased speed or smaller executable files. 

DESCRIBE THE PROCESS OF IDENTIFYING CODE TO MODULARIZE 

There are no hard and fast rules or techniques that can be used for isolating statements in your program that make 
good candidates for modularization. Selecting modules requires practice and as you become more experienced in 
designing logic, the modules will stand out from other statements in your program. That is not to say that there are 
not some considerations that can be made to determine if the program should have modules and if parts of the 
program make better candidates for modularization than others. Some considerations can take in determining if 
code requires modularization are as follows: 

• Does creating a module out of a block of logic contained within the program going to simplify the 
understanding of the program and reduce the possibility of design errors or maintenance errors? If the 
answer is yes, then this code is a good candidate for modularization. 

• Does the code identified for modularization a good candidate for reuse across multiple programs? If the 
answer is yes, then it makes sense to modularize that block of code. 

• Does the code identified for modularization represent a subtask and an independent piece of logic? If it is 
a legitimate subtask, then it is an excellent candidate for a module. 

• Will breaking up the code into modules facilitate multiple programmers being able to work on a program 
in parallel? If the answer is yes, then modularization would make sense. 

• If the code was modularized, would it allow the development process to be done in stages and allow 
development to be done on the program at different times? If yes, then modularization makes sense. 

REPRESENTING MODULE DESIGN IN A STRUCTURE CHART 

We can now introduce a new chart to our programming repertoire. As we begin to modularize our programs we 
will need to nest modules to make the code easier to understand, we will need to somehow document this nesting 
so that we don't add complexity to our solution. We use structure charts to document the calling and nesting of 
modules. A structure chart acts like an organizational chart with the main program sitting at the top of the chart 
and the called modules listed below. If the module calls another module, a line is drawn from that parent module 
to the child modules it calls. Here we have a structure chart example using the sales purchase case study but with 
more complexity and a greater number of modules. 
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Figure 7: Structure Chart Sales Purchase 



In this structure chart, I've changed the original logic slightly to accommodate the nesting of modules. The first 
difference you'll see is that at a new module called printSale(). We'll printSale() calls the modules printDisplay() 
and screenDisplay(). But the structure diagram shows as is that printSale() is the parent and therefore the call 
point of the two sub-modules called printDisplayO and screenDisplay() respectively. For the rest of the diagram, 
both calcDiscountO and calcSalesTax() now have new sub-modules which they call. 

Status Check 

What are some of the benefits of modularization in logic design? 
How does a structure help identify nested modules? 



IDENTIFIER AND MODULE SCOPE 

With the introduction of modules, we now need to return to a discussion of identifier and module scope (scope 
will also appear later in the eBook as we introduce class objects). Scope determines when an identifier or module 
is visible to the statements of your program. Most programming languages support global and local scope with the 
newer programming languages also supporting block scope. Scope can vary by programming language so it is 
difficult to speak of scope in universal terms. Some programming languages support extensive options for scope 
implemented with a modifier or keyword. The scope a programming element can affect the length of time it is 
available in memory, the amount of memory your program reserves and the programs ability to easily reuse blocks 
of code. All of this will be covered in this chapter. 

[types of scope 

Most programming languages typically support to levels of scope and optionally a third. The most common and 
sometimes the most commonly abused scope is global. An identifier or module with global scope is available to 
any statement within the program throughout the life of the program. Local scope is typically associated with 
modules. Typically, when a variable is declared within a module is only available for use with that module and is 
referred to as local. Finally, many of the newer languages are supporting block scope which says that variables that 
are created within a structure, such as an if block or a while block, are only available while the program is within 
the block. A more comprehensive and specific explanation of each is as follows: 
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• Global - a global variable or module is one which is available to the entire program for the entire life of 
the program (unless specifically destroyed within the program). Identifiers with global scope are very 
useful when variables need to be available across to several modules. For example, let's say that during 
the program you're designing you have several places where you need to add to a totalCost variable. By 
making that totalCost variable global, the variable is available to be updated or to be read by any 
instruction in the program. 

• Local - A local variable or module is a element that has been defined to exist only within a program 
module. When control is transferred to the module the variable is declared. The variable or module is 
visible and available to be read or written to only while execution stays within the module. When control 
has transferred back to the module call point local variables disappear along with their contents. If the 
module's called again, the local variables are created from scratch and at the conclusion of the module 
are again deleted. It is possible with module parameters (discussed later in the chapter) to pass values 
from outside the module into the module's local variables. This technique is very important in the 
creation of modules that need to be reusable. 

• Block - Block variables and modules exist only within the structures were they are defined. It is very 
possible that one building a decision structure using an if statement or building a repetition structure 
using a while or for statement did variables are declared to be used with other structures. The statements 
maybe a simple as a sequence structure or the variable could be used in something more complex like a 
nested if or nested while block. As the block terminates, the block variable is released by the operating 
system and the contents are emptied. If control is returned to the structure, just like local variables the 
variables are redefined an error raced at the conclusion of the block. 

Logic Tip: Given the variability in implementing a global, local and block variables, we have assumed and continue 
to assume that all variables defined in a flow chart or pseudo code are global. As we implement pseudo code into 
PYTHON solutions we will see scope modifiers and the existence of local and global variables now become part of 
program logic. 



In Practice: Why not make everything global? - One of my more predictable questions following a discussion of 
global and local variables is a student asking why you would not want to declare all variables as global. Isn't it 
much easier to declare the variable once and then not have to worry about whether using it inside a module, 
inside a block or anywhere in the program? If it is global the variable is always available to be read or to be written 
to. 



The problem occurs when a module with a global variable needs to be reused. If you use local variables and pass 
information into the module via parameters, the variables within the module will always remain local. If you use 
global variable inside a module, this means any time you reuse that module you'll have a requirement to also 
create a global variable. Local variables and modules do not require any code outside of what is contained within 
the module. 

Another less important reason against using all global variables is that the global variable stays in memory until the 
conclusion of the program. Not letting the variable release itself after being used (i.e. a local variable that is 
destroyed when the module ends) is inefficient use of memory and if the application was being developed for a 
smaller device (i.e. a PDA or smartcard), that inefficient use of memory may cause problems running a program on 
these memory constrained devices. 



Logic Tip: We have conveniently omitted the declaration of variables in our pseudo code and flow chart logic 
diagrams. There are provisions in both flow charting and pseudo-code to declare variables used within the logic. 
Typically, since pseudo code and flowcharts don't support extensive data typing, you would typically declare 
variables to be either char (character) or num (number). 
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One of the more powerful aspects of modules is the ability to accept data from other modules or statements 
outside of the module. If the module could only work with statements and data defined within the module, the 
module itself would be very limiting. Modules cannot exist as islands in the program but must exist as resources to 
be called / shared by the program. There have been extensive libraries of modules created for programming 
languages which are designed to be ready for use by programmers. Almost all of these library modules and 
probably most of the modules you'll design will support the passing of data values to the module's logic. Also, 
modules have the capability of returning a data value. Please note that only a single value or object is returned. As 
you'll find in the chapter on arrays and class objects, and object can contain a more than one value so it would be 
incorrect to say that modules return a single value exclusively. 



Key Concept: Modules can contain any number of parameters as input but typically can only optionally single value 
as output. 



PASSING PARAMETERS TO A MODULE 

When a module accepts parameters as input it is not without rules and structure. As the designer of the module 
you are going to set how many parameters can be accepted as input, the data type of those parameters and the 
order in which those parameters must be passed. If the data type is different between the values sent from the 
calling statement to the module, the compiler will return a syntax error. If you send to many or too few 
parameters from the module call statement to the module, you'll also get a syntax error. If the order of the 
parameters sent from the calling statement is different than the order contained within the parameter list, the 
compiler will return a syntax error. 



Key Concept: The number of module input parameters, the data type of the input parameters and the order of the 
module input parameters is critical when passing data to a module. If any of these three rules are violated the 
parameters identified in the module header, the calling statement will return a syntax error. 



Below I have created examples of modules in pseudo-code and in PYTHON. The pseudo code is extremely valuable 
and planning out the logic. PYTHON will allow you to test that logic to ensure that it's working correctly. 

start 

totCost equals 0 

input State Code into stateCode 

call calcSalesTax(stateCode) 

end 

calcSalesTax(inStateCode) 
if inStateCode = "AZ" then 

totCost equals totCost times 1.08 

retu rn 

-The module is called (invoked) with the call keyword. The module has one argument which in turn is passed to the 
module and accepted into the module parameter list. 

- The calcSalesTaxO module accepts the parameter as its own local variable saved as inStateCode. 
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start 



toCosi Bqua\^ 0 

input State Code into slateCode 

call calcSalesTax(stataCode) 

end 

calcSalAsTa]((lnStateCoda) 

if inStateCode = "AZ" then 



totCost equals (otCost times 1 .08 



rebiTi 



call calcSalesTax(stateCode) 



calcSate5Tax(inStateCode) 

if irtStateCode = "AZ" then 

totCost equals totCost 
times 108 

return 



Figure 8: Graphic of relationship passing Input from call point to module header 

In this pseudo code example, the module was called after collecting stateCode input from the keyboard. The call 
statement is passing a single parameter to the module. This parameter is a variable which contains a character 
value. Once the module was called, the value stored within stateCode is accepted into the module and stored 
within a new variable called InStateCode. The variable InStateCode is local to the sales tax module and cannot be 
seen by the main program. Many programmers will choose a name for the input parameter variable that matches 
the variable being sent in the call statement. This is potentially dangerous because in this example stateCode is a 
global variable and the stateCode variable identified in the module parameter list would be local to the module. 
For most languages, this scenario would yield two different variables and depending on the logic in the module, 
this situation could lead to unpredictable results if the programmer is not careful keeping track of each similarly 
named variable. 

In Practice - Terminology Parameter versus Argument - It is common in many programming languages to see the 
terms parameter in arguments used when talking about modules. It's important to understand, that even those 
these terms may sound the same, they're in fact very different. When we call a module, we insert arguments in the 
calling statement to identify the values we want to transfer to the module. In modules, we create parameters to 
accept the values sent to us as arguments. Arguments are used to identify values that are passed when we call a 
module and parameters are the variables we store those values into as we bring them into the modules logic. 

RETURNING A VALUE FROM A MODULE 
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Aside from a module just running a block of code, a module can also return a value. Let's take the same sales tax 
example and change the logic so that rather than updating the global totCost variable, it is passing back the value 
stored in the local variable newTotCost. As mentioned earlier, this is the preferred approach since the solution is 
implemented with local variables. Our previous solution used a global variable which would complicate reusing this 
module and other programs, since any program that used this module would also have to implement the global 
variable totCost. Please note the return statement has identified the value that will be passed back to the call 
point. In this case, the value is stored in the variable newTotCost. 

Let's look At the pseudo code first: 
start 

totCost equals 0 

input State Code into stateCode 

totCost = calcSalesTax(stateCode) 

end 

calcSalesTax(inStateCode) 
newTotCost = 0 
if inStateCode = "AZ" then 

newTotCost equals totCost times 1.08 

return newTotCost 

- The PYTHON statement is an assignment which calls the calcSalesTax() module with a argument (statecode). This 
is accepted as a local variable within the calcSalesTax module. 

- This module is different from the modules covered so far. This module includes a return statement which will 
sent 
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start 

tolCost equals 0 

input State Code into stateCode 

toCost = calcSalesTax{stateCode) 

end 



calcSatesTaxflnStateCode) 
newTotCost=0 

if inStateCode = "AZ" ttien 



newTotCost equals lolCost times 



1,08 



retLirn newTotCost 



totCost = calcSalesTax^stateCode) 




calcSatesTax(inStateCode) 
newTotCost = 0 

if inStateCode = "AZ" then 




newTotCost equals 
totCost times 1.08 



Figure 9: Graphic sliowing return statement returning module value back to call point. 



Key Concept: The logic model in many cases is a perfect world solution. It is language neutral and should never be 
designed w/ith any one language in mind. When implementing logic into a specific programming language, you may 
find that you will need to create program logic that is different than the logic model. This is an acceptable and 
normal response to implementing logic. You should never feel that the logic model is the end all solution that 
cannot be modified. 



Programming Tip: A module can optional have input parameters and return values but it is also acceptable to have 
neither. 



UNDERSTANDING THE MODULE HEADER 

When working with modules, it is very important that you understand how to read the module header. The 
module header leaves important clues as to how to correctly use the module within your program. As I mentioned 
earlier, many modules used in some programming languages are available only as machine code dynamic link 



Procedural Programming Techniques | http://laptoppress.garymarrer.com 



Copyrlgfilct) malanal 



library files (i.e. .DLL file extension). This makes looking at the source code within the module unavailable. If you 
have the header however, you have all the information necessary to use the module and understand any value it 
may return. For starters, the header contains the module name. This is important because you need the module 
name to call the module. The module header also includes the number, order and data type of the parameters 
used, if the module accepts input parameters. Finally, most languages in their programming reference will also 
identify the data type of the value returned by the module. In some cases, as we have seen earlier, the module 
may not return any value at all. 



PYTHON Tip: PYTHON has the ability to store compiled modules that can be called from other PYTHON programs 
with the import keyword. These modules are pre-compiled as byte code files. The source code files are regular 
PYTHON source code files and may or may not be available for the programmer to view (abstraction). This is how 
PYTHON supports code reuse and abstraction. 



In Practice: What's a void anyway? - Many languages expect their modules to always contain the data type of 
return value even if the module returns no value at all. Enter the void keyword. Void is used by many languages to 
indicate that the module will return no information. Void is largely a placeholder and a message to the 
programmer and the compiler/interpreter that this module does not return a value. 



CASE STUDY - CACTUS BOOKS AND TAPES 



Given your hopefully newfound appreciation for organizing code and modules, you have decided to revisit some of 
the work done in the previous chapter for the Chavez sister's book business. Your thinking is that better organized 
code will make the programs easier to maintain and perhaps improve the quality of your solution. You also suspect 
that there are modules in this code that might come in handy in other programs that will need to be developed as 
part of the entire order entry system. 



PART A 



In the last chapter, our case study had two parts. In this chapter, we will return our focus to the Part A problem 
and reevaluate the initial pseudo code and PYTHON code solution. We need to identify those code statements 
which represent subtasks and would be good candidates for modularization. 



Pseudo Code logic solution before modularization 



Start 

Input WSCost 

markup equals 1.25 

handling equals 5 

loyaltyBonus equals 0 

quantityDiscount equals 0 

Input custLoyalStatus 

If custLoyalStatus = true then 

loyaltyBonus equals 1.5 percent 
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Input Qty 

if Qty >=3then 

quantityDiscount equals 10 
SubTotal equals WSCost times markup plus handling 
custDiscount equals subTotal times loyaltyBonus less quantityDiscount 
custCost = subTotal less custDiscount 
Print custCost 
End 

Pseudo Code logic solution after modularization 



Start 



call declareVariablesO 

Input WSCost 

call customerLoyaltyO 

call customerQtyO 

Print salesCalcs(WSCost) 



End 



declareVariablesO 

markup equals 1.25 
handling equals 5 
loyaltyBonus equals 0 
quantityDiscount equals 0 
custCost equals 0 

return 

customerLoyaltyO 

Input custLoyalStatus 

If custLoyalStatus = true then 

loyaltyBonus equals 1.5 per cent 

return 

customerQtyO 

Input Qty 

if Qty >=3 then 

quantityDiscount equals 10 

return 

salesCalcs(newWSCost) 

SubTotal equals newWSCost times markup plus handling 
custDiscount equals subTotal times loyaltyBonus less quantityDiscount 
custCost = subTotal less custDiscount 

return custCost 



- Start of the pseudo code with its four modules are defined. Notice, that each of these modules is a sub-task of 
the entire program. 

In our new solution, we have identified four sub-tasks the qualify as pseudo-code modules. We have identified a 
module for declaring our logic variables as declareVariablesO arid a second module called customerLoyaltyO that 
will contain the code necessary to calculate the customer loyalty discount. A third module called customerQTY() 
which collects how much of the product that customers ordered and finally salesCalcs{) which takes care of all of 
the calculation logic. 
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Main Program 


1 












1 


1 


CustomerLoyalty^) 




cuslomerQTYO 




pfogramCalcsO 



Figure 10: Case Study Structure Chart 



In Practice: Final Refinement (tlie missing PDP pliase?) - We have certainly spent a lot of time in this manuscript 
explaining the importance of following the process. There is a step that most programmers always perform that 
doesn't always show up in the programming development cycle. This step is called refinement. When a 
programmer does refinement he takes his finished program and looks at it one last time for code modifications 
that may make the program easier to maintain or possibly run faster. These changes are made with the confidence 
of knowing that the fundamental logic is sound and has been tested. These last changes are partly cosmetic and 
partly refinement. It is a step similar to something done by any craftsmen, who during his final inspection, finds a 
slight defect that, he would like to repair. Many times this type of change is subtle and has only marginal benefits 
but dedicated programmers want their programs to be as perfect as time allows and reflect positively on their 
ability. 



PUTTING IT TO USE 



The intent of this section is to introduce the new programmer to standards and techniques frequently used by 
professional programmers. Topics in this section relate to concepts introduced in the chapter but with a more 
vocational or occupational focus for students considering a career in programming. 

ADDITIONAL TOPICS: THE MAIN PROGRAM... THE MAIN METHOD... THE MAIN FUNCTION... 

Inside this chapter, I have referred to the main program on several occasions to identify a place in the program 
that controls the flow of instructions and calls to modules. Main is a term used frequently in programming. In the C 
family of programming languages, which includes Java, A main function/method found within a program 
represents the programming starting point. This may module acts like a conductor or an orchestra. It determines 
the sequence of where the program must visit to implement the solution. It directs the control of the program and 
where it needs to execute next. 

What you get for free ... a program language application programming reference (API). Java and Microsoft .NET 
Framework both provide extensive libraries of built in classes all of which contain methods (again another name 
for a module). For Java, the list of methods that are available to call is literally in the thousands. All of these 
methods could provide very important functions and features to your programs. If you buy into code reuse and 
work not to reinvent the wheel by creating your own version of programs, when a version has already been 
created, you need something that will tell you what's available as a built-in module. Both Java and.NET Framework 
provide extensive help and documentation through their products API (Application Programming Interface) 
documentation. This documentation contains indices and search tools to locate modules by their function. Once a 
candidate for a particular task is located, you can look at the module header to determine how to correctly 
implement it. The header we'll give you the number of inputs, the sequence of the inputs and the data type of the 
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inputs along with information on any returned value. Most of us will reuse modules that have been successfully 
implemented and other programs. You'll tend to gravitate towards and remember names of built-in modules that 
have worked well for you in the past. It's important not to become too comfortable and complacent since new 
built-in modules are created with each new release of a programming language. 



CHAPTER REVIEW 



Chapter summary, highlights, key terms, short answer questions, quizzes and case studies to reinforce topics 
covered in this chapter. 

CHAPTER SUMMARY 

After finishing this chapter you should understand and in some cases, demonstrate the following topics: 

• Define procedural programming techniques and its implications on logic design 

o Procedural programming techniques add an element of organization to programs that make the 
program easier to maintain. 

o Procedural programming allows us to take complex programs and break them into smaller easier 
to solve pieces. 

• Define modularization and describe its benefits 

o Modularization identifies blocks of code in our program logic that stand alone as sub-tasks so 
that we can organize them as modules. This organization makes the code design more efficient. 

o Modules make the program easier to design, easier to maintain, and easier to reuse logic and 
programming code. 

• Describe identifier and module scope and the implications of global, local and block scope designations. 

o Global, local and block scope allow programmers to more efficiently manage memory and better 
design reusable programming code by defining the lifetime and accessibility of identifiers and 
modules. 

o Global scope has a lifetime of the entire program and can be accessed by any statement or 
module within the program. Local scope is reserved for module variables and makes them 
available only for the lifetime of module members exclusively. Block scope is reserved for 
structure variables and have a lifetime equal to the structure block and are accessible only by 
statements within the structure. 

• Describe the process of identifying code to modularize 

o Modularizing program logic is a stepwise process in which the programmer first identifies 
standalone sub-tasks that is called by the main module. The main module controls the program 
flow by directing the calling of statements and modules necessary to come up with a program 
solution. 

o Once modularization is complete, it is useful to diagram the modules and how they're called via a 
structure chart. The structure chart is like an organizational chart except it diagrams the calling 
sequence and relationship between logic modules. At the top of the structure chart, is the main 
module. 
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• Recognize the importance of module abstraction and reuse 



o Abstraction and reuse are critical factors In saving time and therefore money. By reusing code 
that has been developed previously, we avoid creating that same code again In what could be a 
time wasting process. Many reusable modules have their details hidden (abstraction) but 
programmers are informed of module parameters and the outputs returned by the module so 
that these modules can be incorporated Into their programs. 

• Demonstrate how called modules can accept parameters and return a value 

o Modules use parameters to provide a mechanism for inputting values into local module 
variables. The calling statement must match the Input parameters In number, data type and 
sequence. 

o Modules can optionally return a single value back to the call point if the module uses a return 
statement to Initiate the passing back of a value. 

o The module header contains all the information necessary to use a method. Because of the 
abstraction, understanding the details behind the module Is not required. Understanding the 
module header Is crucial to using the module. 

• Recognize how different programming languages Implement modules. 

o Different languages use different keywords to implement modularization. These languages use 
parameters and arguments In much the same way we have used pseudo code and PYHTON. 
Other programming languages define modules with different names like function, method and 
procedure. 

CHAPTER KEY TERMS 



Abstraction 

Application Programming Interface 

Block scope 

Global scope 

Local scope 

Main 

Modifier 

Modularization 

Module header 

Module 

Passing of data values 
Procedural programming 
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Returning a data value 
Scope 

Structure charts 
Syntax coloring 
Void 
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PART 2 INTRODUCTION TO STRUCTURED PROGRAMMING 



CHAPTER 6 INTRODUCTION TO ARRAYS AND STRUCTURES 



IN THIS CHAPTER, YOU WILL LEARN HOW TO: 

• Recognize the importance of tlie arrays to logic models and programming. 

• Define arrays, identify the benefits of arrays and recognize the terms used to implement arrays. 

• Apply the use of arrays in a logic model and PYTHON Program. 

• Recognize application operations which can be effectively implemented with arrays (searches and sorts). 

• Define Structures, identify the benefits of Structures and recognize the terms used to Implement 
Structures 



ADDING MORE FLEXIBILITY TO OUR PROGRAMS WITH ARRAYS 



So far in our coverage of variables, we have established a relationship where typically one variable stores one 
value. This relationship has served us well to this point but it is now time to look at a scenario where one object 
variable can potentially reference several values. Arrays and Structures allow us to implement this relationship. To 
be able to store multiple values with a variable of the same name gives our program scalability and flexibility that 
cannot exist if we restrict our programs to a one variable one value relationship. 

Establishing a one to one relationship between value and variable worked well because we could determine the 
number of variables needed at design time. Design time is that phase of the program development process when 
we are creating logic and coding it into a programming language statement. When we are working in design time, 
we are estimating the number and type of variables needed to build the program. Having only design time to 
declare variables is limiting because sometimes it is not possible to estimate the number of variables a head of 
program execution. Using arrays and structures will allow us to manipulate values known only at the time we 
execute our program. This flexibility is essential in building logic where the number of variables is only known at 
run-time. 



Arrays: An array is a data structure which holds a collection of values all of the same data type and referenced 
under the same name. The values stored within the array are called elements of the array and are accessed via 
their subscript. The subscript acts as an integer address uniquely identifying the each of the elements. Arrays have 
all element values physically stored together in memory. 

Structures: A structure is the data structure that allows values of different data types to be stored together as a 
structure. This is much like fields are combined to form a record (i.e. the employee structure would hold name, 
address, dept no. and salary values of a single employee as a unit). A structure is stored physically within a 
computer's memory much like an array but grouped with the other fields belonging to the structure. 
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Design Time: Design time is the pliase in programming development when the programmer is creating the 
program logic and implementing it into programming statements. Typically, this is the time when the name and 
number of variables are decided and set for the of the program. When you design and code logic and programs at 
design time the assumption is that you can predict the number of variables required in your program. Variables, 
arrays and structures can be declared in design time. 

Run-time: Represents the time when you are executing and interacting with the program. A run-time array is one 
that is declared and assigned when the program is executed. The number of elements and their values can be 
determined by input from the user or from program logic. 

Let's illustrate how an array can make our program more flexible by reviewing the following scenario. Let's say you 
are a teacher that teaches several classes in the computer information systems department. The classes are the 
same but each of the classes has a different number of students. For each test, you like to gather all the test scores 
and calculate a class average to share with your students. In a program that does not use arrays, you would need 
to create a number of variables that would represent each test score, input from the keyboard the score of each 
student and finally add those variables together and divide by the count to calculate the class average. This 
program is not a difficult one to build and one that would be very easy for all of us to solve given the concepts 
learned in chapters one through five. 

Because each class has a different number of students, the class average logic becomes more complex. How many 
variables should I create in my program to capture test scores? Since I have classes that have 10, 25 and 20 
students respectively, should I create a program that captures the largest class (i.e. 25 students)? I will certainly 
need one variable for each student. A program that calculates the average for 25 students would work wonderfully 
for my class of 25 but would not work for either my class of 20 or my class of 10. When the program with 25 
student variables is executed, it will ask for 25 test scores. If I only had ten students, to complete the program, I 
would have to register a score of zero (or some other score) for the 15 scores I didn't have. This would not work 
out very well for calculating the correct average. I would not return a calculation even close to the true average. 

For this particular scenario, an array offers us a more flexible solution. An array is a collection of variables of which 
all share the same name and the same data type. A program to calculate class average (that uses an array) could 
ask the teacher first how many students are in their class at run-time and then size the array accordingly so that 
each student would have their own element to store their test score. Arrays, unlike variables, can be sized and 
declared at run-time and adjusted to fit the requirements of the program logic. 

Another advantage to using arrays is when program logic dictates and unusually large number of variables. 
Declaring and using large numbers of variables make the program harder to maintain and potentially more prone 
to errors. Assigning blocks of variables via an array offers the same kind of efficiency we took advantage of earlier 
with repetition structures. Whereas we argued that the repetition structure reduced the number of program 
statements, arrays can reduce the number of different variable names we need to maintain in our programs. We 
can now look at the variables as a block and use the array subscript to move through the block and conveniently 
access potentially hundreds of variables. All with the same name but differentiated with the subscript. 



NEW DATA STRUCTURE OBJECTS FORMALLY INTRODUCED 

Both arrays and structures also represent a departure from variables. A program variable is no more than a name 
that represents an address in our computers primary memory. When we call the variable name (also known as a 
primitive variable) the system is translating that name into a memory address. The system automatically returns to 
us the value stored at that memory location whenever the variable is called or has a value assigned to it. 
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Programming Tip: A variable refers to a primitive data type. Primitive data types hold the value (numbers or 
characters) of the variable at a location in computer memory. An object variable holds the address of the block of 
memory that stores the objects values (or a series of primitive data types). Arrays and structures are objects and 
not primitive variables. 



With both structures and arrays, we are no longer referencing a single value in memory but many values stored 
together under the same name. Because of this, the referencing of arrays and structures require a different 
approach. We still reference arrays and structures by name but instead of the value being associated with the 
variable, the variable name now holds the address in memory where the array or structure can be located. 

If you stop to think about this, it does make sense. With a variable we know that the number stored in that 
variable can only be so large. Maybe we need just four bytes to store even very large numbers. In the case of an 
array, what if we had 1000 numbers? If these numbers were a data type of integer, then perhaps the amount of 
memory needed would be 4000 bytes (4 bytes times 1000 values). Perhaps the next time we created an array, we 
only had ten elements and thus for this execution 40 bytes (4 times 10) would serve us fine. Can you see how the 
amount of memory needed is not known at design time so it is not practical to use a primitive data type with its set 
size but instead an object which can be sized accordingly. 

You will see this concept of objects versus primitive data types addressed again as we get into object oriented 
programming and class objects. Spend some time with the diagrams provided that show graphically the 
relationship between both a variable in computer memory and an object variable in computer memory 

INTRODUCING ARRAYS 

Arrays are specialized data structures which allow us to build a collection of variables. The variables in this 
collection are called elements and they're all referred to by the same array name. What differentiates the 
elements in the array is a subscript or index. The subscript acts as an address to uniquely identify each element in 
the array. For most languages, the size of the array or the number of elements it may hold is set when the array is 
declared. The size of the array cannot be changed (however, you can copy smaller arrays into larger arrays.) In 
addition, most programming languages require that all of the elements in the array have the same data type. In 
other words, if the array is of type number all of the elements must also be number values. Arrays are not 
restricted to just numbers and characters. Arrays may also contain elements of other data types like arrays, 
structures or objects (i.e. an array of arrays or an array of structures). 



Element: An element is the name given to one of the values stored in the array. If the array is declare and store 5 
values, it is said to have 5 elements. The number of elements is determined when the array is first declared. 



Programming Tip: Programming languages have different ways of implementing array declaration and 
manipulation. Before coding your array, you would be wise to consult the programming reference for the proper 
technique in implementing arrays for that language. 



Programming Tip: An integer is a whole number that has no reminder (or decimal). 



Subscripts: A subscript is an integer that uniquely identifies each element in the array. Subscripts typically start at 
0 and increment by one until the last element. The subscript is identified after the array name in inside square 
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brackets " " or parenthesizes "( )". Subscripts are also commonly referred to as indices by some programming 
languages. 



REASONS FOR USING ARRAYS 

There are many reasons for using arrays in your programs. The four most compelling reasons for using arrays 
would be: 

1. Not knowing the number of variables needed until runtime 

2. For a large number of variables that would be difficult to assign unique names 

3. A requirement to implement a search or sort mechanism within your program logic or 

4. A need to improve program performance. 

In addition, many programmers will use arrays as an alternative to variables out of personal preference. Each 
individual element of an array is identical to the variables (i.e. primitive data type) we have discussed so far. 

FLEXIBILITY OF ARRAYS 

As already noted, one of the most beneficial features of arrays is the ability to set the number of variables at run- 
time. As the above example illustrates, the averaging of test scores with arrays creates a much more flexible test 
averaging program. Being able to set the number of elements at run time provides a very important feature not 
available with just variables. This feature makes a tremendous difference in the flexibility of the programs we can 
create. 

In addition, many times an array is helpful when a large number of variables are need but when naming those 
variables uniquely would be a problem. Assigning variable names for fifty state codes would be much more difficult 
with primitive variables (i.e. statel, state2, stateS, etc.) than as an array that hold the fifty state codes as elements 
(i.e. stateCodesSO). 

SEARCHING AND SORTING 

When our programs need the ability to search through large a number of values or sort in ascending or descending 
sequence a large number of values, arrays offer us a flexible and efficient way of implementing program searches 
and sorts. Using repetition structures to take advantage of the incremental nature of subscripts and the fact that 
arrays hold values together in memory, combine to make arrays a very efficient way of searching and sorting data. 

Performance 

For many programmers, one programming trick which has long been a favorite for increasing the performance of a 
program is the use of arrays when data needs to be frequently accessed by the program. For many programs, 
tables of data need to be loaded to correctly calculate or look up parameter values. This data could be accessed 
from a file system existing in secondary storage (i.e., a hard disk) or from an array existing in primary storage (i.e. 
computer internal memory). If the data is searched from a disk file the access time will be in milliseconds. This is to 
be contrasted with the access time of computer memory which is measured in nanoseconds. That difference in 
time, although small, can significantly impact the speed of your executing program. 



INTRODUCTION TO ARRAY TERMS AND CONCEPTS 
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Like all computer topics, arrays have their own set of terms and concepts that we must review before starting to 
include arrays in our logic models and programs. Even though there are differences in implementing arrays across 
different programming languages, there are certain terms that will be found in all environments. I will focus on 
these common terms and concepts in this chapter. 



ARRAY ELEMENT DEFINED 

As mentioned earlier, the values of the array are stored in elements. These elements are identified uniquely by 
their subscript or index. In the following array, I have graphically represented five elements which each hold a 
number. For most programming languages, array elements start with a number zero and increase by one the 
subscripts must be numeric and they must be integer best provide a unique address for each element ( more on 
this and the next section). 
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Single Dimension 
Integer Array 
Holding Five 
Elements 



89 



Subscript 0 



77 



Subscript 1 




Subscric 



98 



Subscripvt 3 



69 



Subscript 4 



Figure 1: An Array of Five Integer Test Scores 



I ARRAY SUBSCRIPTS AND INDEXES EXPLAINED 

The subscript uniquely identifies the elements of the array. The subscript itself must be unique and for most 
languages are typically integers. The first element of the array has a subscript of 0 with the other elements each 
having a subscript one greater than the subscript in front of it (see the single dimension array diagram for a 
graphical representation of this concept). 
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Single Dimension Array 
5 Elements 
5 Rows 
1 Column 



Element 1 

Subscript 0 



Element 2 



Subscric 



Element 3 



Subscript 3 



f 



Element 4 

Subscripl 3 



Element 5 



Subscript 4 



Figure 2: A Single Dimension Array with Elements and Subscripts Labeled 

Subscripts are typically shown inside brackets next to the name of the array. In the following statement, the value 
stored in the second element of an array called myArray would print to the display. 



print myArray(l) 



In Practice: Arrays subscripts start with Zero - One of the more confusing aspects of using arrays is dealing with 
subscript addresses. For almost all programming languages, the first element of the array has a subscript address 
of zero. Since for and while loops provide such an elegant mechanism for looking through elements of an array, 
sooner or later you will all probably encounter the "one over error." What this error refers to is a situation where 
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you set your loop counter to equal the number of elements in the array. If the number of elements of the array Is 
five, setting the Boolean logic in the repetition structure to the number of elements will take you past (one 
greater) than the last subscript for the array. When you get to that fifth element and try to display its value, you 
will have returned to you a runtime error from the interpreter or operating system. The exception returned will 
point to the fact you have designated a subscript that is out of range. A subscript which is one more than a highest 
subscript associated with that array. Like the endless loop error discussed in an earlier chapter, this is an error 
every programmer makes it least once in their programming career. Some of us will admit it still happens on 
occasion. 



Status Check 

Can you define an element and subscript? 

How can arrays help add flexibility to your programs? 



DECLARING ARRAYS 

When you declare an array, you must identify name and the type of data stored in each of the elements and the 
number of elements within the array. Some languages, because of the way global scope is implemented, will allow 
you to declare the array name before the number of elements is declared. This technique of using two statements 
to declare and build an array in memory is also the way in which class objects are implemented in programs. In 
pseudo code, I could declare a number array called myArray with five elements as the following: 

num myArray(5) 



Programming Tip: A five element array would have subscripts of 0,1,2,3, and 4 to identify each of the elements in 
the array. 



ACCESSING ARRAY VALUES 

When working with individual elements of the array, we need both the name and the subscript of the element. If 
we wanted to replace the value in the third element, which has a subscript of two, we could generate a statement 
similar to the following: 

myArray(2) = "test value" 

• myArray is the array name 

• the right and left bracket enclose the subscript 

• the equals (=) sign indicates an assignment where the character constant "test value" is stored in the third 
element of myArray. 

This next statement would take the value in myArray(2) (currently with a value of "test value" and store it into a 
string variable called message. 

message = myArray(2) 

Can you see the similarities between a variable and a single element of an array? 
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MULTI DIMENSIONAL ARRAYS 



As you would have seen from the diagram above, a single dimension array (which is what we have discussed so far) 
looks much like many boxes stacked on top of one another. All single dimension arrays have one column and many 
rows. It is also possible to create multi-dimensional arrays. The most common of these multi-dimensional arrays 
are two dimensional arrays which have multiple columns and multiple rows (much like a spreadsheet has rows and 
columns). In addition, you can also work with arrays that are three and four dimensions but these arrays are 
difficult to conceptualize and outside what we can cover in this eBook. We concentrate on single dimension arrays 
in our case studies but we will spend a little time in understanding how single and two dimensional arrays are 
different. 

When accessing elements in a two dimensional array, I have two subscripts. One subscript identifies the row and 
the second subscript identifies the column. Below, I have created a graphic showing a two dimensional array with 
the array subscripts identified in the diagram. 
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^^^^^^^^^^ 




Subscript 0.0 


Subscript 0,1 








1 


Row 2 Column 1 


Row 2 Column 2 




Subscript 1,1 


Subscript 1,1 


2 


Row 3 Column 1 


Row 3 Column 2 




Subscript 2,1 


Subscript 2,1 




Row 4 Column 1 


Row 4 Column 2 




Subscript 3,1 


Subscript 3.1 


4 


Row 5 Column 1 


Row 5 Column 2 




Subscript 4,1 


Subscript 4,1 



Figure 3: A multi-dimensional array diagrammed 

The declaration of a two dimensional array is similar to a one dimensional array as the code statement below 
illustrates: 

oneDimArray[10] 
twoDimArray[10][5] 

The single dimension array named oneDimArray has ten elements with subscripts 0 through 9. The two dimension 
arrays of the named twoDimArray has 50 elements with subscripts addresses 0,0 to 4,9. The two dimension array 
also has subscripts and that start at 0. The difference is in the fact that with a single dimension array you have one 
subscript and with the Multi-Dimensional array you have at least two subscripts. 
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In regards to assigning a value to a two dimensional array tlie same rules As with a single dimension array also 
apply. To store a value of 10 in the 3rd row 2nd column of an array called twoDimArray would look like the 
following in pseudo code: 

twoDimArray(2,l) = 10 

Take note of the subscripts. They are one less than the rows and columns requested above. This is to compensate 
for the fact that multi dimensional arrays also start with 0 for both the first row and first column. 

PARALLEL ARRAYS 

Parallel arrays describe a scenario where two or more one dimensional arrays have information related/linked by 
subscript. In other words, I might have one array of data type number that has five elements all holding a Social 
Security number. In a second array, I might have five string elements of data type character each holding a 
person's name. In the construction of both of these arrays, I made sure that the element from one array was 
related to the element of the parallel array. For example, the zero subscripts for the array holding the social 
security number would correspond to a subscript in the second array holding that person's name. Below, I have 
created a diagram which illustrates the relationship between these two parallel arrays. 
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based on 
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Figure 4: Parallel arrays graphic 



A PRACTICAL EXAMPLE OF ARRAY BENEFITS 



Let's revisit the scenario used in the chapter introduction, fill in a few more details and then show what this array 
would look like in a logic model and also in the PYTHON program. For this example and examples which will follow 
in the eBook, we will start to move away from flowcharting and spend more of our time concentrating on pseudo 
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code and then optionally using PYTHON to validate our pseudo code. As mentioned in an earlier chapter, as our 
programs become more sophisticated it will become increasingly more difficult to construct flowcharts that will fit 
on a reasonable of number pages. 

A SAMPLE PROBLEM TO ILLUSTRATE THE FLEXIBILITY OF ARRAYS 

You'd been asked to create a program for your computer programming instructor that calculates the average test 
score of the mid-terms she has just graded. Your programming class has fifteen students but she has informed you 
that this program needs to work for all of her classes. Her other classes have 10 students and 25 students 
respectively. She needs one program for all three classes and you should design the program so that the teaching 
assistant can specify the number of students and then input each test score from the keyboard. When the last 
score has been entered into the program, all of the test scores will be displayed along with the average calculation 
and the sum of all inputted scores. You have been told that the program needs to include a single dimension array 
to hold the students' scores. The array will enable you to set the number of test scores averaged at run-time. Your 
solution should include Pseudo code of the logic model and a PYTHON program to validate that the logic will work 
correctly. 

SOLUTION PSEUDO CODE: 

In the pseudo code example below, we introduce new code to our logic model. Since we have broadened our 
variables to include array data types, I have created a block of pseudo code dedicated to the variable declaration 
and initialization. We define an empty array called grades[]. Empty brackets are an indication that the array has 
not been sized. The brackets are typically the place where subscripts are located. 

start 

declare variables 

char elementCnt 
char newMember 
num testTotal equals 0 
num i equals 0 
num grades[] 

input "Enter the number of Tests" into elementCnt 

for i = 0 to (elementCnt - 1) 
grades[i] = 0 

input "Enter Score >> " into grades [i] 
testTotal equals testTotal plus grades [i] 
i equals 0 

for i = 0 to (elementCnt - 1) 

print "Test Score " plus i plus " equals " plus grades [i] 
print "Total >> " plus testTotal 
print "Average >> " plus (testTotal / elementCnt) 
3 -This 
end 

- Here the pseudo code identifies an array of data type number called grades[]. This is where the student test 
scores will be stored as elements. The array is currently empty. 
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- This for loop will ask for input and store the test values within the array. The array size is equal to the number of 
elements stored in the elementCnt variable. Sizing the array at run-time allows us to run the program with a 
different number of test scores on each execution. Note the construction of a for loop where the variable i is the 
incremented variable. This variable will start at 0 (for the first subscript) and exit the loop when i is one less than 
the total number of elements. It will exit one less than the total elements because the subscripts start at 0 and not 
1 (like elements). 

- Here we have one final for loop to print the contents of each element in the array along with the print statement 
for both the test total variable and no one of the test average 



Logic Tip: Up to this point we have conveniently omitted variable declaration from our pseudo code examples. This 
has been done so that we can place more focus on the actual logic statements but in reality robust pseudo code 
should include variable declaration. Please take note of the proceeding example and how variables have been 
defined in the pseudo code program. Pseudo code like most programming languages expects to see variables 
declined that the beginning of the program and before their used in logic statements. 



Status Checl< 

Why must arrays contain elements of the same data type? 

What would the subscript of an element on the second column of the three row in a multi-dimensional array? 
ADDING VARIABLES AND ARRAYS DECLARATION TO PSEUDO CODE 

Please take note of the above pseudo code. So far in our pseudo code training, the declaration of variables has 
been conspicuously missing from our logic models. Up until now we have been working almost exclusively with 
global variables. There has been little need to identify anything specific when declaring variables. Until this 
chapter, where we've introduced arrays and structures, we have been able to cheat a little on variable declaration. 
We will now want to describe variables in our pseudo code programs. 

You will see a new block of code placed within my pseudo code to identify all the variables, arrays and structures 
used. If the discussion of modules is still fresh in your mind, you might well be thinking that the declaration of 
variables and arrays might qualify as a sub-task of the program. This is correct. I could create a module called 
declareVar variables and include all these declarations within it. A word of warning here, as you will remember 
from the previous chapter, for many programming languages, declaring variables in a module will make them local 
and only visible to statements within the module. They must be defined to be visible where they are being used 
and therefore thought must be made in defining variables as global or local. 



Related Subject - Dynamic Arrays and Collections - Most programming languages have several structures related 
to arrays but which have slightly different features available to them. Many languages support a data structure 
called a vector. The vector is identical to the array and that it has one name, a number of elements, and a rule of 
all elements containing the same data type but in addition has the flexibility to expand and contract based on the 
programmers parameters. 



Still another, and the most sophisticated alternative is a collection, this data structure is dynamic in that it can 
expand and contract based on the number of elements. It is also more flexible and that it can typically support 
multiple data types. This means that the first element might be a number and the second element might be a 
string and the third element might be something different stale. A final advantage to using collections over arrays 
and vectors is the ability to not only reference elements by their subscript but also by a key value. For example, if I 
create a collection of employee information, I could select employee number as my key field and use that 
employee number reference to find that element within the collection. Using keys to access collection elements 
requires that each key is unique. 
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MODULES OWNED BY OBJECT 



As mentioned earlier in the eBook, an array is actually implemented as an object. An object not only holds data but 
it also contains methods. Methods are object modules and represent behaviors. In other words, methods are small 
blocks of code that because of their usefulness or association with that object are included with every object 
created. What this means, is that when we created our array we also automatically received a series of modules 
that provide help or assistance and performing some activities associated with that object. 

For example, most arrays have a property value automatically created which contains the number of elements in 
that array. This property becomes very useful when creating for and while loops that need to move through only 
the number of subscripts identified for that array. Rather than relying on the programmer to determine the 
number of elements in the array, the array length property can be accessed to automatically return the number of 
elements based on the declaration statement used to create the array. Another useful member of the array object 
is the copy method which allows us to create copies in memory of our original array so that we may work on the 
copied values without changing or damaging the initial array. 



Background Information: Arrays help relate procedural and object orientated programming - As described in our 
last programming tip, the coverage of modules and procedural programming in chapter five and now the coverage 
of arrays in chapter six, are moving us still closer to the point where we introduce object oriented programming 
(OOP). There are many ways to learn about OOP. Many textbooks cover just object orientated techniques and 
include structured programming in the discussion of methods. Another approach and one that's used in this 
eBook, is to take the student to object oriented programming by way of learning about structures and procedural 
programming first. This approach is one where the students start the learning process with more basic concepts 
and moves gradually towards more complicated concepts. As we talk about objects in this chapter, and introduce 
array properties and method, we inched closer to the point where we can discuss how to create our own objects. 



USING ARRAYS WITH REPUTATION STRUCTURES 

Arrays are uniquely suited for repetitions structures. Because the array contains a collection of elements 
identifiable by each elements subscript, you can easily create a repetition structure like a for loop or while loop to 
increment through the subscripts and call each value element by element. The for loop is especially well suited for 
moving through an array. By definition, a for loop controls loops execution by iteration. Iteration can be described 
as an activity that increments or decrements a incremented variable by one. If we begin our for loop at the zero 
element and increment by one to one less than the total number of elements in the array, we can easily move 
through the entire array element by element inspecting the values as we loop. Because the subscript contains an 
integer value, we can use the incremented variables to identify the subscript. Let's illustrate with the following 
example. I have an array of 5 elements. I need to do a linear search of this array which means that I must inspect 
each element to determine if it the equals the value I am searching for. If the value is found, I would like to know 
what elements in the array contained this value. Let's create a pseudo code program to solve this problem. Take 
special note of the for loop (a repetition structure) and an if statement (the decision structure) and see how they 
all come together to perform a linear search of a single dimension array. 

start 

declareVariables 

num subscript 

num myArray= [12,22,23,99] 
nun cnt = 0 

for onto to myArray. Length minus 1) 
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print "Element" plus (subscript + 1) plus myArray[subscript] 

end 



- Here the array uses a pseudo code for statement to loop through the elements of the array called myArray. 

- This statement concatenates the string literal "Element" to the element number (subscript + 1) and the value 
stored in the array printing the location and value of the element. 

There are a couple of items included in this pseudo code program which are new. For starters, I've included a logic 
step called declare variables where the working variables are declared. This includes the numeric array called 
myArray. With a declaration of this array, I used a coding convention common to many programming languages 
which allows you to declare the array and initialize its values in one step by declaring the array through the 
assignment of array elements. This array has five elements with subscripts that will range from 0 to 4. 

I've also used the array length property to help set the upper bound of the looping criteria. Since the total number 
of elements will exceed the highest subscript by one, I have deducted one from the array length property so that 
the loop will stop processing when the subscript reaches for. I have also identified the starting point for the for 
loop as zero so that the first array element is also inspected for the desired value. 



Programming Tips: For new programmers, using subscripts incorrectly can lead to logic errors. The IDE debugger 
can be very useful tool in following through the looping process and watching the looping variable along with 
subscripts change on each cycle. Problems with using looping variables as an array subscripts are common and 
difficult to spot. Build in IDE debuggers can make the process much easier. 



When the program executes it will move through the elements, starting with element zero, and compare the value 
of that element to the number 99. An if statement is being used to determine if a match exists and if it does, the 
true branch if the if statement will print two lines indicating that the value has been found and where in the list it 
was found at. Again, notice that in the final print statement I add one to the subscript value so that the number 
indicating which element held 99 is displayed as an element number and not the subscript. The subscript, since it 
started zero, would be one off if we counted down the subscripts to the variable that held 99. 

ARRAY PROCESSING 

In this section of the chapter I have included several examples of array processing. Like many of the code samples 
I've included the eBook so far, these pseudo code and PYTHON programs represent common uses of arrays. 

Linear Search of an Array 

When we speak of a linear search, we are referring to a program module or block of code that will move through 
the elements of an array in either ascending or descending order inspecting the contents of each element for a 
specific value. This process is called linear because it must process beach elements one after the other from the 
first to the last element. A linear search is very easy to design but due to the fact that the array cannot be 
randomly searched, a linear search can sometimes be slow. For smaller arrays, there's no question that this is the 
best approach. For larger arrays, there are other logic blocks, such as a binary search, which would find elements 
located at the end of the array quicker than if they were being found using a linear search. 

PSEUDO CODE LINEAR SEARCH 



start 

declareVars 

myArray = [12,22,23,99] 
subscript = 0 



Adding more flexibility to our programs with Arrays | http://laptoppress.garymarrer.com 



searchValue equals 99 
for subscript = 0 to (myArray.length - 1) 



if (myArray(subscript) = searchValue)then 

print "Found value" plus myArray(subscrlpt) 
print "at element" plus (subscript + 1) 

- The if statement inside the for loop checks the value stored in each element against the search value. If the value 
is found the true branch is executed and two lines are printed with a message containing location information on 
the matched value. 



Linear Seach 
of a 

Single Dimension Array 



myArrayn 



for LOOP 

if myArray[i] = 99 then 



22 
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Figure 5: Linear Search Graphic 



A BUBBLE SORT 
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A bubble sort is a very useful and functional way of taking advantage of the power and flexibility of arrays. When 
computer programmers talk about sorting, they're talking about taking a data set and putting it in ascending or 
descending sequence. For most computers this is numbers first letter second with both incrementing smallest to 
largest. The bubble sort gets its name from the way it gets its values in sorted order. A bubble sort takes an array 
populated with values and bubbles the lowest values to the beginning of the array. It does this by comparing a pair 
of values. If that it is an ascending sort in the second value is less than the first value and these values will need to 
be switched in the array. The first element is compare to the second the second element is compared the third the 
thirties compare to the fourth and so on for all the elements in the array. Since the comparison is only taking place 
between values next one another this process of comparison needs to take place one less time than the number of 
values in the array. If we have an array with four values there are not only four pairs of values to compare but also 
a requirement to do the pair comparisons four times. On the fourth time you can be assured that all values are 
placed in the correct sorted order. 

PSEUDO CODE BUBBLE SORT 



start 

declareVars 

char arrayOfStates equals ["NY", "AZ", "PA", "DE", "AK"] 

num arrayElements 

num outerCnt equals 0 

num innerCnt equals 0 

num tempSwapVar 

num stateValues 

arrayElements equals (arrayOfStates. length -1) 
while (outerCnt < arrayElements) 

innerCnt equals 0 

while (innerCnt < arrayElements ) 

if (arrayOfStates[innerCnt] > arrayOfStates[innerCnt + l])then 

tempSwapVar equals arrayOfStates[innerCnt] 
arrayOfStates[innerCnt] equals arrayOfStates[innerCnt + 1] 
arrayOfStates[innerCnt + 1] equals tempSwapVar 
innerCnt equals innerCnt + 1 
outerCnt = outerCnt + 1 
print "Print Array in Ascending Order" 
for StateValues to arrayOfStates 
print StateValues 

- arrayElements comes from the length of the array minus one and is used to control the outside and inside loop 
because this number represents the number of pairs and the number of outside iterations. This value is used for 
both the number of pairs to compare and the number of this the pair comparison must take place to get all of the 
values in sorted order. 

- A counter variable is used to control the number of times the pairs are compared. 

- The inside while loop also uses a control variable to determine the number of pairs to compare. 

- This if statement compares one array to the next and makes sure they are in ascending sequence. If they are not, 
they are switched. 
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- The next three statements complete the switch. It stores the switch variable temporarily In a temp variable and 
performs the switch. Without the temp variable, the switch would not work because one of the variables would be 
overwritten 



Bubble Sort Using an 
Array 



array Of States^ 




Subso'lpt 1 




'PA" 



Subscript! 



"DE" 



Subscript 3 



"AK" 

Subscript 3 



First Iteration 

1st Pair NY, AZ - switcli MY with AZ 

2nd Pair NY, PA - no switch 

3rd Pair PA, DE - switcli PA with DE 

4tti Pair PA, AK - switcli PA witli AK 

Wew Order AZ,NY,DE,AK,PA 

Second Iteration 

1st Pair AZ.NY -no switch 

2nd Pair NY, DE - switcti NY with DE 

3rd Pair NY, AK - switcli NY with AK 

4th Pair NY, PA - no switch 

New Order AZ,DE,AK,NY,PA 

Third Iteration 

1st Pair AZ,DE -no switch 

2nd Pair DE, AK - switch DE with AK 

3rd Pair DE, NY - no switch 

4th Pair NY, PA - no switch 

New Order AZ,AK,DE,NY,PA 

Forth Iteration 

1st Pair AZ,AK - switch AZ with AK 
2nd Pair AZ, DE - no switch 
3rd Pair DE, NY - no switch 
4th Pair NY, PA - no switch 
New Order AK,AZ,DE,NY,PA 
Complete for Ascending Sort 



Figure 6: Bubble sort logic showing pair comparisons and Iterations 



RELATED INFORMATION: DIFFERENT SORTS 



Adding more flexibility to our programs with Arrays | http://laptoppress.garymarrer.com 



Copyrlgfilct) malanal 



There are several versions of the bubble sort algorithm. Some versions are more efficient than others in the 
number of passes required to get the items and sorted order. What is meant by this is that it is possible to have the 
data in sort in order before all the looping is complete. This happens in situations where the data already exists in a 
sorted sequence. If you do some further research into bubble sorts and sorting you'll find some of these 
alternative algorithms. For this book, which concentrates primarily on fundamental concepts, we will focus on the 
simplest version of bubble sort one that is still just as accurate in terms of delivering data in ascending or 
descending sequence. 

Status Check 

How does an array help with applications that need to perform a linear search or bubble sort? 
Why is an array more like an object than a primitive variable data type? 



CACTUS CASE STUDY 



This chapter on arrays has come at a great time. The Cactus Books and Tapes book order application has a 
requirement which appears to be ideal for implementation using an array. The current application has the user to 
entering wholesale cost. This is a not something that the customer and the web site will have access to. In the 
Internet application, the user will click on a book in the click action will identify the item code of the publication. 
Later in the application, all of the books in inventory will be accessed from a database. At this point in the 
application, database access is not important but be able to determine the correct cost is. One way to simulate to 
look up within the database is to use parallel arrays that will take the item code from one array and match it to 
another array that has wholesale cost. The Chavez sisters have identified five items which are typical of the kinds 
of products that will be purchased over the Internet. You are to use this information to build parallel arrays. 

I have included the application as it stands from the previous chapter after modularization. We will create a new 
module to handle the cost look up. The cost look up will perform a linear search against the item code and then 
use the subscript to a parallel array holding the item cost to determine the cost. 



Item Code 

1001 

09921 

23 

13123 
5544 



Item Cost 

$23.50 
$4.90 
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$15.25 

$.90 

$4.90 



Programming Tip: When it comes to picking a data type for numbers you usually have several choices but you can 
always have the number stored as a number or stored as a character. You would store as a number if the variable 
will hold a number that is used in a calculation. If you have a number not used in a calculation, like a social security 
number, zip code or telephone number, you will want to store these numbers as a character to facilitate string 
manipulation. Many numbers are "smart numbers" (i.e. phone number has area code, exchange and number) and 
to be able to look at parts of the number is important. If would be highly unusual to use phone number in a 
calculation 

PREVIOUS CHAPTER PSEUDO CODE SOLUTION AFTER MODULARIZATION 

Below I have taken the pseudo code from the previous case study to be used as a starting point in adding a linear 
search capability. 



Start 



call declareVariablesO 

Input WSCost 

call customerLoyaltyO 

call customerQtyO 

Print salesCalcs(WSCost) 



End 



declareVariablesO 

markup equals 1.25 
handling equals 5 
loyaltyBonus equals 0 
quantityDiscount equals 0 
custCost equals 0 

return 

customerLoyaltyO 

Input custLoyalStatus 

If custLoyalStatus = true then 

loyaltyBonus equals 1.5 per cent 

return 

customerQtyO 

Input Qty 

if Qty >=3 then 

quantityDiscount equals 10 

return 

salesCalcs(newWSCost) 

Sublotal equals newWSCost times markup plus handling 
custDiscount equals sublotal times loyaltyBonus less quantityDiscount 
custCost = subTotal less custDiscount 

return custCost 
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- 1 have decided to declare all variables in a single module. Module declaration is a sub-task of the entire program 
and presents an excellent candidate for modularization. 

- In this pseudo code program, I've placed the main logic on the top of the code listing and the functions and the 
modules below. In the PYTHON program, I have to observe four declaration rules of all modules and therefore 
have to place the function blocks at the beginning of the program before the main program statements. Different 
programming languages will have different requirements concerning the placement of modules. 

New Module Pseudo Cost 

wholeSaleCostO 

searchVar = 0 
foundValue = 0 

itemCodeArray["1001", "09921", "23", "13123", "5544"] 
itemCostArray[23.50, 4.90, 15.25, .90, 4.90] 
Input itemCode 

for searchVar = 0 to 5 

if itemCodeArray[searchVar] = itemCode then 

foundValue equals itemCostArray[searchVar] 
return foundValue 

return 

- In this part of the program, you see the for loop that performs the linear search. If the search is successful and 
the value we are searching for is contained within one of the elements, the value is stored in a variable called 
foundValue and then returned back to the program for printing. 

INTRODUCTION TO STRUCTURES 

A structure is a data type that is similar to a multi dimensional array except that has only one row in multiple 
columns. However, unlike an array, a structure can have columns of different data types. Typically, we use 
structures in much the same way that we use records in a data file. Just like a record that has multiple data fields a 
structure has a row with multiple columns. Just as a record exists in secondary storage on some disk media, a 
structure like an array exists in memory only. We have already discussed the performance benefits of arrays due to 
the speed in which the computer access is primary storage. The same performance improvements can exist when 
files are taken from secondary storage and added two structures and primary storage. 
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structure: Order Record 
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Pseudo Code - Declare Structure and Assign Values to Array 
start 

declareVars 

Structure: order 
char CustID 
char ProdID 
nun Cost 
char OrderDate 

order.CustID equals "1" 
order.ProdlD equals "434" 
order.cost equals 10 
order. OrderDate = "1/1/2004" 

end 

Figure 7: Simple Structure Graplilc and Pseudo Code 

A common teclinique for placing a file in memory is to create an array of structures. Look at the graphic of the 
structure first and see how a structure simulates a file record and then see how an array of structures can simulate 
a file stored in memory. 
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Single Dimension Array of Structures 
5 Structures 



start 



3 



Structure 1 
Structure 2 

Siibscript 1 



Structure 3 

Subscripts 



Structure 4 

Subscript 3 



Element 5 

Subscript 4 



end 



declareVars 

Structure:order 
char CustID 
char ProdID 
nun Cost 
char OrderDafe 

array Structures[1 0] 

order.CustlD equals "1" 
order.ProdID equals "434" 
order.cost equals 10 
order.OrderDate = "1/1/2004" 
arrayStructures[1] = order 

order.CustlD equals *'2" 
order.ProdID equals "543" 
order.cost equals 1.45 
order.OrderDate = "3/13/2004" 
arrayStructures[2] = order 



Figure 8: Array of Structures Graphic and Pseudo Code 



Background Information: When it is "Virtual" - It is very common to hear the word virtual in conversations about 
programming. The word virtual is used to describe when something has been placed in memory. This is the case 
when we take files taken from the hard drive and organize them as an array of structures in memory. You will also 
hear the word virtual to describe hardware that has been simulated in memory. For example, in the past, when an 
operating system was reloaded from CD or floppy disks; a virtual drive was created in computer memory to speed 
up the performance of the operating system installation. The drive in memory is a virtual drive and has a letter just 
like the floppy drive has a letter on a computer. When you hear something described as virtual, you should expect 
to find that involves placing some component in computer memory. 
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Programming Tip: structures are implemented differently in different programming languages. Some 
programming languages have omitted the use of structures in favor of class objects. Typically, a structure is very 
similar to a class object that only contains data. Structures are very common in programming languages that are 
ancestors of the C family of languages. 



PUTTING IT TO USE 



The intent of this section is to introduce the new programmer to standards and techniques frequently used by 
professional programmers. Topics in this section relate to concepts introduced in the chapter but with a more 
vocational or occupational focus for students considering a career in programming. 



Best Practices: Program Design Patterns - There has been a lot written over the past several years about 
programming patterns. Most of the discussion of patterns has focused on Java and specifically object oriented 
programming. Even though this is not a textbook on Java, I believe that the concept of program design patterns 
has relevance even in procedural programming. Essentially it says that many programs include blocks of code that 
are common and therefore reusable to many programs. There is a rule called the 80-20 rule which states that 80% 
of the work takes 20% of the effort and 20% of the work takes 80% of the effort. The idea here is that the common 
tasks are done much easier and uncommon tasks take most of the time and effort. I would modify the 80-20 rule 
slightly to make it pertain to design patterns. What I would say is that 80% of the time programmers reuse logic in 
program code because that code solves a common function. If the programmer concentrates on learning common 
logic sequences (design patterns), they will undoubtedly be much more effective programmers. 



Patterns Discussed in the EBook so far 

• Linear search of an array, (chapter 6) Reading an array with a repetition structure and the array length 
property, (chapter 6) 

• Bubble sort (ascending and descending) sort of an array, (chapter 6) Counting with a repetition structure, 
(chapter 4) 

• Loop with flag or sentinel value, (chapter 4) Accumulating with a repetition structure, (chapter 4) 



187 



Putting It to Use | http://laptoppress.garymarrer.com 



Cocyrlghlcd matenal 



CHAPTER REVIEW 



Chapter summary, highlights, l<ey terms, short answer questions, quizzes and case studies to reinforce topics 
covered in this chapter. 

CHAPTER SUMMARY 

After finishing this chapter you should understand and in some cases, demonstrate the following topics: 

• Recognize the benefits and importance of the arrays to logic models and programming. 

o Arrays are specialized data structures which allow us to build a collection of variables. This allows 
us to easily create and reference a large number of variables and also allows us to declare array 
elements (variables) at run-time. 

**Compelling reasons for using arrays are their ability to: 

■ Be defined at design time or run time. 

■ Allow a large number of variables to be assigned easily and efficiently 

■ Useful for programming patterns such as search or sort 

■ Improve program performance. 

• Define arrays and recognize the terms used to implement Arrays 

o An array is a collection of variables of which all share the same name and the same data type. 

o The subscript uniquely identifies the elements (individual values) of the array. The subscript itself 
must be unique and for most languages are typically integers 

• Recognize application operations which can be effectively implemented with arrays (searches and sorts). 

o A bubble sort takes an array populated with values and bubbles the lowest values to the 
beginning of the array putting the values in sorted order. 

o A linear search allows us to move through the elements of an array in either ascending or 
descending order inspecting the contents of each element for a specific value. 

• Define arrays, identify the benefits of structures and recognize the terms used to implement Structures 

o A structure is a data type that is similar to a multi dimensional array except that has one row in 
multiple columns. The columns, unlike an array, can be of different data types. 



CHAPTER KEY TERMS 



Arrays 

Ascending Order 
Bubble Sort 
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Descending Order 
Design Time 
Elements 
Linear Searcli 
IVIulti-Dimension Arrays 
Parallel Arrays 
Run-Time 
Structure(s) 
Subscript 
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PART 2 INTRODUCTION TO STRUCTURED PROGRAMMING 



CHAPTER 7 - THE BASICS OF FILES AND DATABASES 



IN THIS CHAPTER, YOU WILL LEARN HOW TO: 



• Define a file and recognize terms and concepts associated with file processing. 

• Define a database and recognize terms and concepts associated with record processing. 

• Differentiate between reading and writing to files and databases. 

• Define XML and recognize terms and concepts associated with file processing. 

• Define Structure Query Language (SQL) and describe its importance to database processing. 

• Describe and apply file management processes of add, change and delete. 



ADDING DATA PERSISTENCE TO PROGRAMS 



So far we have spent a great deal of time focusing on programming logic. Although logic is at the foundation of any 
program, there has been one component of programming that has been suspiciously absent so far. The logic and 
programs we have created so far all had one thing in common. None of the programs created have supported 
reading and writing to a disk file (secondary storage). Disk drives comprise the primary means of supporting 
secondary storage and providing our programs with program persistence. Data persistence is a term used to define 
the ability of programs to save data and return to it and reload that data at later date when the program is run 
again. 



Data persistence: Data persistence allows programs to write program data to secondary storage only to be 
retrieved at a later session. For example, a mailing list program would need to be able to add, change and delete 
mailing label data to a file so that the mail labels could be printed every time the program was executed. 



Take the case of arrays. An array is a very useful data structure for manipulating a large number of data values. The 
problem is an array is built in memory and when the program finishes, the memory locations are released back to 
the operating system and the data is lost. Most applications that you will develop will probably read in data saved 
from a previous session and write that data to a secondary storage device when the program completes. In this 
chapter, we will discuss many forms of data persistence. We will cover sequential data files which have historically 
been used to capture character data. We will cover database files that have become the preferred mechanism for 
storing organizational data. We will also take a look at new technologies like XML which are establishing itself as 
the standard for using data from desktop applications to Internet applications. . 
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Logic Tip: When programming we make a distinction between data and information. Although they are used 
synonymously, data is the raw material and information is the finished product. Data (numbers, characters, text) is 
transformed by program logic into information. To use a familiar example, a paycheck, net pay and gross pay are 
information and the payee, hours, pay rate are the data used to calculate the information. 



Secondary storage device: a secondary storage device is computer hardware that works with storage media to 
read and write data. Examples of secondary storage devices would be a hard drive, a floppy drive or a read / write 
CD-ROM. 



Sequential data files: sequential data files hold records of character data which can be viewed using a text editor. 
These data files can consist of free formatted text or formatted text were columns of data are lined up by their 
column position to form fields. 



Database files: Database files are maintained by database management software to hold data that is maintained 
by the database management software. Data security and accuracy are managed by the database management 
system. 



XML: XML is a standardized scripting language used to define the format and values of data stored in a text file. 
XML is a popular format for use in Internet applications due to its ability to move freely from client to server. 



FUN-DAMENTALS 

On closer inspection of the table of contents, you'll find many of the topics in this eBook concentrate on 
fundamental knowledge of many programming topics. This chapter is no different and will provide basic 
information and knowledge regarding file and database processing. Perhaps this chapter more than any of the 
others in the eBook will cover a wide range of topics but only on the surface level. The storage and retrieval of data 
is such a critical part of information processing there are countless strategies and technologies to contend with. 
We will be unable to study storage and retrieval in a comprehensive fashion. We will give you enough to 
understand how to provide file maintenance operations from your programs. 

HISTORY OF DATA PROCESSING - TRANSACTIONS PROCESSING 

Programmers have been using data files as part of their application programs for almost as long as there has been 
programming languages. Traditionally, computer programs were created for what was called back office 
operations. Back office operations are business applications which are typically involved with the processing of 
large numbers of transactions against the master file. Back office applications include applications like payroll, 
order entry, general ledger, accounts receivable and accounts payable. The reason that these applications were so 
successful is because the speed of the computer to accumulate and manipulate transaction data. File processing 
also greatly improved these business processes are providing an inexpensive easy way to store large amounts of 
data. There are stories of some of the larger insurance companies literally running out of building space trying to 
store the paper records necessary to service their customer accounts. The speed in which the transactions can be 
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calculated and the ease and which they could be stored on file systems represented the first real benefits offered 
by computers to business. 



Back office applications: Back office applications are a type of business application that includes the electronic 
record keeping of business transactions. Back office applications include general ledger, payroll, accounts 
receivable, accounts payable and order entry to name a few. 



FILE PROCESSING FUNDAMENTALS 

For most of us who are familiar with personal computers, file processing fundamentals will sound familiar. With 
the popularity and the extensive use of personal computers, we all have experience accessing files from floppy 
diskettes, hard drives and CD ROMs. If you are new to computers, then it is important that you spend time on your 
computer learning about the utilities provided by the operating system to manage files. For the Windows 
operating system, Windows Explorer is a file management utility included with the operating system and very 
important in copying, deleting and renaming files. It is important how ever to keep in mind that all files are not the 
same and files come in many formats. We will start with an explanation of terminology and coverage of some of 
the popular file formats. We hope to broaden your understanding of files and give you a better appreciation of 
how files are used in programming. 

WHAT IS A FILE PROCESSING UTILITY? 

Microsoft Windows is the most popular operating system for desk top computers so we should start there when 
discussing file management utilities. For moving, copying and deleting files, Windows Explorer and My Computer 
are two utilities that will help you manage files. This utilities offer alternatives to the command based file 
management commands used in the predecessor of Windows, Microsoft DOS. You should have experience with 
both of these tools but if you are new to computers spend some time going through the toolbar and pull down 
menus to understand some of the file management options available with Windows Explorer. 

FILE TERMINOLOGY REVIEWED 

As a programmer, it is important that you understand the jargon and technical language associated with 
computers in general and for file processing specifically. For most students, learning computer jargon is probably 
the most frustrating part of taking a computer class. The textbook, the teacher, and some of the students use 
words which are obviously connected to the computer topic being covered but sometimes represent concepts 
which don't exist in everyday vocabulary. As much as I would like to say that learning computer jargon is not part 
of learning how to be an effective computer programmer, this is not the case. You will find that learning new terms 
and concepts is a lifelong exercise if you choose a career in computers. Technology changes at an exponential rate 
and with each change in technology, new words and acronyms are created to explain the features and functions of 
that technology. In the spirit of becoming more informed about file processing jargon, I will review many of the 
terms used by programmers when developing applications that involve reading and writing to files. 

• File system - when we talk about a file system, we could define it in terms of an index card box filled with 
index cards. As described in earlier chapters, this would be a manual file system but still a file system. A 
file system is a technique of storing and retrieving data in a systematic repeatable fashion. In a computer 
file system, the operating system determines how files are stored, what constitutes valid naming 
conventions and how files are kept secure. The operating system can actually perform many more 
functions with files but we'll start with this short list. 

• File - a file is a collection of related data typically organized as records. This data (stored on the secondary 
storage medium as bits and bytes) can represent raw data (i.e. payroll information) instructions to an 
operating system (i.e. a compiled application program) or any data or information that needs to be stored 
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and then retrieved at a later date. A file has a name which is governed by the operating system naming 
rules and optionally has a file extension which also helps to classify the type of file. 

• File Extension - The file extension is typically used to Identify the file. The file extension is implemented as 
a three character suffix after the dot(.) at the end of the file name and helps to indicate the type of file it 
is. Text files are typically designated with the .TXT extension. File extensions are standardized with some 
products (i.e. .XLS is the file extension for a Microsoft Excel spreadsheet file). 

• File Folder - a file folder works the much the same with files as a Manila folder works with paper. A file 
folder is a container that holds other files and helps to better organize files by placing related files in the 
same folder. With the newer operating systems, it's very easy to accumulate thousands of difference files 
in a very short period of time. The last time I did a full virus scan on my home PC, it scanned over 400,000 
files on my hard disk. Without folders and sub-folders (folders inside folders) to organize secondary 
storage, finding files on a computer could be a very time consuming process. 

• Record - A record is a standard unit of measure of transaction file processing. It represents a block of 
information about an entity. The entity could be a product, an employee, or customer. Within the record 
contains fields each of which holds a particular data attribute related to that entity. 

• Data field - a data field represents a particular item or data attribute of an entity or record. In a record 
holding customer information, a data field might represent that customer's name or perhaps the amount 
of sales conducted with that customer. 

• Character - a character represents the smallest unit of measure in regards to file processing. A character is 
a single letter or number which is found in the data field. 
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A computer can hold many files. 




A record consists of many fields each containing one element 
of data (i.e. name) 



Name 


ftddress 


P" 

City state 


Zip 


Here we have a record with actual data 


Jotin Doe 


1 Main Street 


Anylcwn 


A2 


95555 



Figure 1: File Hierarchy 
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Status Check 

What is a traditional application for transaction file processing? 

Using the file hierarchy, list the largest to smallest element of a file (hint - file is at the top)? 



INTRODUCTION TO FILE MAINTENANCE 

Whether you're working with the file (or database) you have three basic file maintenance operations at your 
disposal. You may insert information to a file. You may update or change information in a file or you may delete 
data from the file. 

File maintenance: File maintenance is defined as the add, change and delete operations performed on data. These 
operations are performed by traditional file systems and database management systems. 

ADD, CHANGE, DELETE CONCEPTS 

Given the importance of file maintenance operations, it's appropriate that we review each of the operations 
individually. 

The add operation (sometimes called insert or append) allows us to place new data in our file. Depending on the 
file system (file system versus database file system), the addition of new data is typically placed after any existing 
data or at the end of the file. Add a new customer record is an example of an add operation. The update operation 
allows you to take existing data within the text file or database and modify or change that data. Updating a 
customer record with changed address information is an example of an update operation. The delete operation 
allows you to remove data already present in a text file or database. Like most things in life, everything sooner or 
later loses its usefulness. Old and infrequently accessed data may slow down the performance of the entire 
system. 

You can look at data deletion as like cleaning out the garage. At some point, the garage become so cluttered that 
becomes difficult to find the things that we really use. The removal of a customer record for a customer who has 
not done business with you organization over an extended period of time is an example of a delete operation. 

Related Subject: Should you ever delete? - There is certainly a school of thought that would promote the concept 
of never deleting data. Some of the rationale around this is partly based on the belief that even deleted data has 
value for historical analysis and partly based on the fact that the price of secondary storage (i.e. disk drives) is so 
low that retention of company data provides a greater benefit than the cost. Another important concern in favor 
of keeping data might be a business reporting requirement mandated by Federal or State regulatory law. 

SEQUENTIAL FILE PROCESSING DEFINED 

Sequential file processing (also called sequential text file processing) represents the most primitive form a file 
management and also the oldest. Long before relational database management systems and object based 
databases, businesses efficiently and effectively used sequential text files to hold customer information and 
process that information as part of back office business operations. 
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Programming Tip: The term sequential file processing comes from the fact that this l<ind of processing reads 
record by record throughout the file processing each record and its set of fields individually. Processing in 
sequence, one record after another. Thus we get the term sequential processing. 

Typically, most of these back office transaction based systems used two types of files to maintain business 
information. The first file type was a master file that represented more permanent data. Master files also include 
summarized data from transaction files. A customer file that contained the customer name, address, phone, along 
with current balance data is an example of a master file. This file would contain all critical customer data along 
with data fields which capture updated information on current balance, last payment data and last purchase date. 
The master file also typically contains a unique identifier like a customer ID that allows another type of file called a 
transaction file to link to the master and update it with transaction (detail) data. 

Master file: A special kind of file that contains accumulated transaction data. Master file data represents more 
permanent data. Traditionally found in environment that processed text files, it can also describe data stored in a 
database table. 

The second file used in back office processing is called a transaction file and holds detail data about the customer's 
transactions on a monthly basis. The transaction detail contains charges and payments. As a company, you might 
set up your transaction processing such that a transaction file included all payments and charges by all customers 
for a particular month. At the end of the month when billing needed to take place, you would run the transaction 
file against the master file adding and subtracting charges and payments so that the master file now reflected the 
processing of this month's transactions. 

Transaction File: transaction files hold the detail records of the business. A customer credit card charge or 
payment would represent a transaction. Transaction file records are typically summarized and then used to update 
master records. 

Using transaction files to collect detail transaction data and a master file to hold accumulated data provides an 
excellent audit trail to ensure the data is accurate. The audit trail also provides the ability to research problems 
through a transaction history to find and fix any problems. Data safety and accuracy was especially important to 
companies using computers for the first time and in the sixties and seventies when companies were just starting to 
use computers for record keeping. 

Background Information: What should I call a text file? - When working with sequential text files you have to be 
aware that there are several terms that all describe the same thing. A sequential text file can go by the name of 
text file, by the name of flat file and by the name of sequential file. When a text file contains program source code, 
you might also hear the term script file, source code file or macro file. Unfortunately, there is no one term to 
describe a sequential text file so you'll need to prepare to hear any one of these terms. One characteristic of a 
sequential file which should be a constant is that all sequential files contain a series of records that are placed one 
after another in the file. 
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Figure 2: Files found on your PC 
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Folder 



File Name 




t 

C:\AcmeData\December\Payroll.csv 

111 



Drive 
Designation 



Sub Foider 



Fiie 
Extension 



Figure 3: File naming conventions 



Today, sequential processing is still an important part of new programmer's instruction. Many corporations have 
moved away from traditional sequential file based processing in favor of database management systems which 
processed records randomly and not sequentially. However, sequential styles still show up in many desktop 
applications so program data to be saved in reloaded. One common technique is loading configuration information 
at program startup and saving configuration information on program closure. For example, your program may be 
robust enough to allow the end user to set colors, graphics or icons as part of their application session. To make 
this functional, you would need to save this information from session to session so that the next time the user sits 
down and uses your program all of the settings he had saved in a previous session would reload automatically. This 
is an excellent example of writing and reading from a sequential file. 

Programming Tip: Random processing of a file or database does not process records in the order they are saved 
but instead can access records in a random fashion across the secondary storage. If you are not updating large 
blocks of records next to one another, random access can provide a better performing solution than sequential 
processing. Random access is typically facilitated by a key field that is unique in the file. 

Sequential text file processing remains an important technique when there's only a small amount of information 
which needs to be manipulated. The overhead and time required to set up a database may create a scenario 
where sequential text based processing is the more effective and efficient solution. 

Although not used as much today as it was a few years ago, sequential files can also be an effective way of moving 
data from one program to another. For example, you may have a Microsoft Excel spreadsheet that you wish to 
move into another software application as input. If you save the spreadsheet as a text file, a program could be 
written to use that text file as input. By being able to read this sequential file, you have a mechanism for getting 
information from one program to another. 

Record Processing 
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Since both master files and transaction files typically consist of many records, program logic must be developed to 
read records sequentially starting with the first record and ending at the last record. This process is called record 
processing. Fortunately, a repetition structure, which we have covered in a previous chapter, works very well and 
allowing us to move sequentially record by record through our file. In its simplest form, this record processing can 
be accomplished by creating a Boolean expression within a while loop that simply test the existence of any more 
records to process. If the field tests as empty and containing no data, then that last read operation was unable to 
retrieve data from the record and therefore left the variable empty. Many programming languages have built in 
functions to assist the programmer in determining when they should no longer try to read from a data file. These 
built in functions are typically placed inside the Boolean expression and will return a true or false value based on 
evidence of additional records to process. 

Record Processing: Whether you are in a text file or a database table, there will be occasions when you will have 
to process a number of records in one session. You will be required to add record processing logic that will consist 
of a repetition structure that loops through the records one at a time until all records are processed or until you 
reach the end of the file/table. This programming activity is called record processing. 



Programming Tip: Files and records may be different but the logic/programming pattern using repetition 
structures to read and process data record by record is used by programmers over and over again. 



READING AND WRITING TO TEXT FILES 

All of us had our first exposure to reading and writing as elementary grade students. We're going to revisit reading 
and writing from a different perspective. When working with secondary storage, there are actually two kinds of 
activities that can take place. We can read information from those devices or we can write information to those 
devices. Usually we do both or what is called read-write access. 



Read: When we retrieve data from a file/database in secondary storage we call this activity a read. 



Write: When we save data to a file/database in secondary storage we call this activity a write. Example: Reading 
from a Sequential File 



Just as with other programs we have created so far, the approached used in developing sequential file applications 
follows the same process. We will start with a plan, then do some fact finding to understand the requirements. We 
will then designed our solution first with a logic model and then with the actual coding of the logic model itself. We 
will have a new step that requires us to use a text editor to design and populate a text file with actual data. We will 
conclude by testing the application to ensure that it is free of run-time and logic errors and then finally roll out the 
solution into production fully documented with users trained. We will demonstrate a simple file processing 
application that reads and writes from a file. With this, you'll see pseudo code patterns emerge that use the 
control structures covered in previous chapters. 

TEXT FILE RECORD PROCESSING IN PSEUDO CODE 

Below I have enclosed a sample snippet of pseudo code that demonstrates how a repetition structure moves 
through a file a record at a time to read field data into variables that can be manipulated in the program and then 
saved back to the file in a write operation. 

open mylnFile for Input 
open myOutPile for Output 
while name not equal to blank 
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prodID equals mylnFile(l-lO) 
prodName equals mylnFile (11-20) 
ProdCost equals mylnFile (31-10) 
prodCost equals prodCost times 1.1 
myOutFile write prodID, prodName, prodCost 

close mylnFile 
close myOutFile 

- The file is opened. A file may be opened for Input, Output or Append. Append would add records to the end of an 
existing file where as Output would create a new file or overwrite an existing file. 

- Text file fields are stored into variables to allow the program to modify record values. 

- prodCost is increased by 10 per cent 

- the variables are written to myOutFile 

- All files are closed. 



PSEUDO CODE OF READ AND WRITE OPERATION 



Here is a file read operation along in pseudo-code needed to implement a program and test it. Before we can 
model the logic, we must have some idea what the record layout looks like. Below I have opened a file with 
Microsoft Notepad so we can see the record layout. This particular file includes four fields in a classic sequential 
text file. You need to position the cursor in Notepad to see where each field starts and stops. This information will 
be needed when we read each record field into variables (which will represent each data field in the record). For 
this file, the name field starts in character position one and extends for twenty characters. The second field 
contains street information and starts in column position 21 and is also twenty characters in length. The third field 
is city and it starts in character position 41 and again is twenty characters in length. Finally we have state code data 
field for two positions that start and character position 61. 

Record layout: the record layout identifies the column positions of each field In the text file. The layout shows the 
starting column position and the length of each field. 



Gary Marrer 2 Main street Anytown AZ 
John Doe 4 Apple Ave Glendale AZ 
Jane Doe 4 Apple Ave Glendale AZ 
Bob Day 334 Apple Lane Glendale AZ 



Background Information: A text file editor and creating text files - You may have heard the term text editor used in 
conversation. The term describes a certain type of application program which allows you to open text files and 
make changes the data contained within that file. For UNIX users, a popular text editor, which has stood test of 
time, is called VI. For Microsoft windows users, the preeminent text editor has been Microsoft Notepad. All 
operating systems typically come ship does utility the text editor to allow you to modify text files. The text editor 
operates much like the editor and the IDE. 



The pseudo code will need open the file and then read each of the fields from the file before it can print the 
record. The while loop is used to read all records until no more records are found. A while loop first reads each of 
the fields of the record, stores the field values into a variable and then prints the variables to the display. If the 
read takes place and there is no data in the name field the while loop exits knowing that the records had all have 
been processed. When the while loop is complete the program is finished and all files are closed. 
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start 

open myfile 

name equals 999 

while name not equal to blank 

name equals myfile(l-20) 
street equals myfile(21-20) 
city equals myfile(41-20) 
zip equals myfile(61-20) 
print name 
print address 
print city 
print state 
print zip 

close myfile 

end 



Background Information: Text File Types - Comma Separated Values Files - Sequential text files come in many 
formats. One of the formats which have traditionally been popular with programmers of personal computer 
applications has been the comma separated file format. When programmers work with data, the data is typically 
stored in a record and field format. What this means is that each line (record) in the file represents information 
about a particular entity. Let's say an entity like a customer. In that line of information, is several values associated 
with a customer. One value might be their name and the next value might be their address. The field values will 
each be delimited (or separated) by a comma. Thus the name comma separated file. The arrangement where the 
comma separated each data field is a specifically useful for breaking out the field data included in the record. See 
the following example 



"John Doe","l Main Street","Anytown","AZ", 123.33, 12 

Where fieldl is name, field2 is street, fields is city, field4 is state, fields is price and field6 is quantity. 
Status Check 

What actions are included as part of file processing? 

What is the difference between reading and writing to a file? 



CACTUS CASE STUDY 



The cost look up program from the last chapter that was designed using arrays was a success. A decision was made 
to expand a test to include a larger number of books using persistent data stored in a file that could be altered as 
new books are added to inventory. After some discussion with the Chavez sisters, a text file was created to hold 30 
records containing the data field's item code; item cost and item name. 

You must now modify last chapter's case study application where we hard coded the item values within the array 
at design time to an application that will read from a data file at runtime. Your new program will read from a file 
the book values into the array to be searched. You will not be required to write any information to a file for this 
case study. 

Since the process steps for designing applications that use data files is Identical to the process steps we have 
identified for previous applications, you must modify your earlier design to include pseudo code that reads a file 
into an array. Once the pseudo code has been updated and the logic appears to meet the requirements, you must 
then take the pseudo code and move it over into PYTHON so the application logic can be tested. 
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The following table documents the file layout of the ProductFile 
ProductFile Record Layout (only first five records shown) 
Item Code 

Start position 1 for 10 bytes Item Cost 
Start position 11 for 10 bytes Item Name 
Start position 21 for 30 bytes 



1001 $23.50 Roadside Wild Flowers of Arizona 
09921 $4.90 The PYTHON Quick Reference 
23 $15.25 Building a Bird House 
13123 $.90 Street Map of Durango Colorado 
5544 $4.90 The Best of Practical Jokes Part III 
Pseudo Code Logic Model 



Start 

call declareVariablesO 

newWSCost equals wholeSaleCost() 

call customerLoyaltyO 

call customerQtyO 

Print salesCalcs(WSCost) 

End 

declareVariablesO 

markup equals 1.25 
handling equals 5 
loyaltyBonus equals 0 
quantityDiscount equals 0 
custCost equals 0 

return 

customerLoyaltyO 

Input custLoyalStatus 

If custLoyalStatus = true then 

loyaltyBonus equals 1.5 per cent 

return 

customerQtyO 

Input Qty 

if Qty >=3 then 

quantityDiscount equals 10 

return 

salesCalcs{newWSCost) 

SubTotal equals newWSCost times markup plus handling 
custDiscount equals subTotal times loyaltyBonus less quantityDiscount 
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custCost = subTotal less custDiscount 
return custCost 
wholeSaleCostO 

searchVar = 0 

foundValue = 0 

call loadFileO 

Input itemCode 

for searchVar = 0 to 5 

if itemCodeArray[searchVar] = itemCode then 

foundValue equals itemCostArray[searchVar] 
return foundValue 

retu rn 

loadFileO 

itemCodeArray[30] 
itemCostArray[30] 

open ProductFile 

for i = 0 to 29 

itemCodeArray[i] = read(lO) 
itemCostArray[i] = read(lO) 
buffer = read(21) 

next 

close ProductFile 

- First we open the file ProductFile for input 

- We now read a record from file and load it into the array. 

- We close the opened file when complete. 



DATABASES INTRODUCED 



For small and large organizations, databases provide a popular mechanism for storing and retrieving data. 
Databases offer improvements of data accuracy, data security and speed of access over traditional file systems. 
Databases also help reduce data redundancy (typically found in traditional file systems) which can also be 
important in making sure that the data remains accurate. 

Data bases are still very much an evolving technology but are our most stable and secure alternatives to storing 
and retrieving data. The first databases were primarily hierarchal and network designs. Most databases used today 
follow a relational design based on relational algebra. Databases are an enormous topic that far exceed what we 
can cover in this eBook. At college I teach at, a certification in database technology would require a minimum of 
five to seven classes over an entire semester dictated specifically to a particular function of databases. The focus in 
this eBook is on relational databases. Relational databases are by far the most popular and most common and the 
workplace. Relational databases are designed around principles of relational algebra. What makes a relational 
database different than other databases is that all data is stored within tables. The tables have rows and columns 
and if columns. Tables can also be joined (or combined with other tables) to create complex and flexible views of 
the organizations data. 
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Figure 4: Database Overview 



TRADITIONAL FILE SYSTEMS VERSUS DATABASES 

In many respects, you might consider databases the next generation of the traditional file system. The traditional 
file system was developed in the sixties for handling back office applications. Consisting of a series of files holding 
master and transaction data that when combined can produce reports needed to manage the business. In back 
office applications, each file works with an application program that coordinates the processing of two or more 
files. Since it is not easy to bind multiple text files (i.e. combine), one of the weaknesses of traditional file systems 
has been its propensity to allow for redundant data. What this means is that as application programmers 
developed new applications they tend to get around this problem of joining text files by putting more and more 
data in the text file duplicating a significant amount of data. When information exists in more than one file there's 
real potential for the files to become unsynchronized (not to mention wasted space from redundant data located 
in more than one location on disk). Data redundancy is seldom a good thing. One example often used to illustrate 
this weakness is the problem of record updates. If I have two files that both contain customer address information 
and I change one of the files but forget to change the other, my files now are different and I have a problem. If the 
file that didn't get changed is the billing file, my customer's invoice no longer goes to the correct address. If I use 
this address for shipping, they also do not get their order. A very bad situation for business. 

Databases are actually applications (also known as database management software or database management 
system) that control and coordinate maintenance of organizational data. Instead of the programmer being able to 
directly access files and uncoordinated fashion, a data base environment requires that the programmer work with 
the database management software. The database management software provides coordinated security that does 
not exist in traditional file systems. 

In addition, when the data in the database is created, the database management software requires a series of 
rules concerning the data, called constraints, to be defined by the person adding tables to the database. These 
rules help to ensure that redundancy is minimized and critical unique data is not duplicated. If index or keys have 
been created to assist the merging of different tables, the database software ensures that the accuracy of the data 
is not compromised. Whereas sequential files only contain data, a database contains many application programs 
which sit between the user and the data to ensure that security in accuracy are not compromised. 
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Database Application 
Program 




Figure 5: A database management system 



Database Management Software (Systems): Is a software application that sits between the user and the data and 
controls the security and accuracy of data. Popular database management software is Microsoft Access, Oracle, 
MS SQL Server, IBM DB2 and MySQL The Database Management Systems (DBMS) act as a layer between the users 
of data and the actual data. 



An additional component of database processing that is more difficult to implement in traditional file processing is 
a two phase commit. A two phase commit allows the user/programmer to send a transaction to the database and 
optionally back off the change to its original state If the change with cause a data inaccuracy (i.e. two uses or 
programs trying to access and update the same information at the same time thus having one change negate the 
other). In most databases, the two phase commit process uses the COMMIT command to commit changes to the 
database and ROLLBACK when the data change needs to be rolled back to its original value. 



Two Phase Commit - the ability to implement a two phase commit allows the program to verify the integrity of the 
change before the database is officially updated. The control is necessary for a number of reasons but the most 
important scenario is when two users (or programs) try to update the same row at the same time. As one is 
changing the date of birth and the other the address, it is possible for one program to change the date of birth and 
the other program to update the address (with the old date of birth). With the ROLLBACK option, we could undo 
the transaction and restore the data back to its original state. 



Background Information: What databases do you use? - Everyday, most of us use many databases. Sometimes our 
use of databases isn't that obvious. When you go to the ATM machine and you withdraw or deposit money from 
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your account, you're using an application program which is communicating with a database that is updated when 
you mal<e your ATIVI transaction. 



Maybe you're worl<ing on the job and perhaps taking an order from a customer. The application program which 
you are running in Microsoft Windows has text boxes and buttons along with menus and toolbars to accept 
information concerning the order. It is not the Windows application that holds the information you are processing. 
The application is communicating with a database program and acts as the interface to your data stored in the 
database. As the person processing the information on the order, you have certain security privileges which have 
been awarded to you by the table creator. As you fill out the information on the screen and then submit the order 
for processing, the appropriate tables in the database are modified. Your updates make this information available 
for other users of the organization to use. Does this sound familiar? If you are a student, do you access systems like 
this for grades or student information? 

DATABASE TERMS EXPLAINED 

• Table - A table is very similar to the file that we defined earlier in the section of the chapter on sequential 
file processing. In addition to holding data organized as rows, a table is built using constraints which help 
to protect the accuracy of the data but prevents unique column data from being duplicated and prevents 
required column data from being left empty. 

• Row - A row in a database has the same relationship as a record to a file. A row in a database represents 
information about a particular at entity. A row could reflect entities like a customer or perhaps a product. 

• Column - A column is very similar to a data field in a record. In our traditional sequential file processing, 
we used the data fields to hold specific information related to each entity. A column holds specific data 
related to a row or entity. A column might hold the customer name, the customer number and perhaps a 
current balance of a particular customer. 

• Primary key - As part of ensuring data accuracy within the database, one technique used is to create a 
primary key table constraint. A primary key is a column which contains information that would uniquely 
identify each row in the table. Primary keys cannot be duplicated in a table. For example, social security 
number is often used to a uniquely identify an individual. This is because the only one person is allocated 
one social security number. There are no two people and have the same social security number. A primary 
key works the same way. If a column has been designated as holding the primary key none of the rows 
within that table can have that same primary key value. If a user tries to violate this constraint the 
database would return to the user (or the programmer) a referential integrity error flagging the 
transaction as invalid. 

• Foreign key - A foreign key is a special column that has a unique relationship with another table's primary 
key. For example, we have two tables, one called EMPLOYEE and one called DEPARTMENT. The primary 
key in the DEPARTMENT table called DEPTNO is related to a foreign key called DEPTNO in the EMPLOYEE 
table. If someone was to delete a primary key that was the same value as the foreign key in the 
EMPLOYEE table, the database management system would return an error. The implication of this 
relationship is that if a user tried to delete a department record and that department number was 
assigned to an employee in the EMPLOYEE table, the deletion action would be denied by the database 
because it violated the foreign key programming constraint. Just think about it, if you worked in 
department and someone try to delete department and from the DEPARTMENT table, it would make your 
database row and accurate. This is another example of the database enforcing rules to protect the data 
from inaccurate data. 
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• Data View - A data view is unique to relational databases. A view is a virtual table made of several tables 
in the database. The table appears as if it was a physical table but in fact is the result of merging data from 
various tables into one virtual table. It is not uncommon for many applications to have to need to extract 
data from several tables. The view can simplify programming and security by treating the virtual table the 
same as a physical table. 



BACKGROUND INFORMATION: THE DBA 



DBA stands for database administrator. The database administrator has responsibility for creating and maintaining 
database objects (tables, views, etc.). Additional responsibilities include availability and performance of the 
database as measured by access time and speed of retrieval. The DBA is a very specialized position that requires a 
number of years of education and training specifically focusing on databases. A DBA is typically has full security and 
authorization to completely control the database and assigns access permissions (via database privilege roles) to 
database users. 

Status Check 

A field to a database is like a column to a table. Explain this relationship. 

What will a unique key constraint placed on the phone number column in a database mean to the application 
programmer? 

STRUCTURE QUERY LANGUAGE (SQL) 

Structured query language or SQL (pronounced SEQUEL) is a procedural programming language specifically 
designed for use on relational databases. This language allows you to create database tables and other database 
objects like views. It can also be used perform queries to extract information from one or more tables. You can use 
SQL to set security and also can be combined with a variety of database functions to perform fairly sophisticated 
programming. As a relational database user, it is critical that you spend the time learning all but about SQL. SQL is 
easy to learn and there are many sources on-line available to help you in a learning process. SQL for the most part 
is standardized but built in database functions vary across database products so you should locate the SQL 
reference for the database you are using. 

Most programming languages work hand and hand with SQL. The programming language provides the logic and 
the SQL facilitates extracting the data from the database management software. It is important if you are working 
towards a career in programming then knowledge of SQL is important for your success. 

Structured query language: is a programming language available with relational databases that allow the user to 
create, update and delete database table information. The language also acts as the interface between the 
database administrator and database settings allowing the DBA to control the database configuration. The most 
common SQL statement is the select statement that allows the user to query rows and columns from one are more 
tables. 



Related Subject: Database Constraints - When we hear the word constraint it typically means there is a limitation 
has been placed on our ability to complete that process. This is partly the case with database constraints. When a 
database table is first designed, the designer will look at the columns within that table to determine if the data 
(specifically the column definition) must be unique or not empty. The database creator with the proper SQL 
commands can place the constraints of uniqueness and not null on columns such that anyone who uses that 
database must follow those rules if inserts and updates are to be successful. Constraints help ensure database 
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accuracy by preventing invalid data from ever being written to the database. For example, if the column has been 
designated as not null, no records can be inserted into the database if the row does not have a value for that 
column. 



SIMPLE SQL QUERIES USING SQL SELECT 

A complete coverage of the SQL programming language is outside the boundaries of this eBook. However, we will 
cover a subset of SQL commands that fall under the SQL sub-category of data manipulation language or DML. DML 
commands include INSERT, DELETE and UPDATE. That with these commands in the proper database privileges, a 
data base user can perform basic file manipulation (add, change delete). 



Data manipulation language: DML is a subset of SQL commands responsible for table maintenance. DML 
commands allow the user to INSERT, UPDATE and DELETE database data. SQL also supports Data Definition 
Language (DCL) commands which allow users to create, change and delete tables and Data Control Language 
which allows users to set security privileges for database objects (tables, views, etc.). 



We will start with the most commonly used SQL command and perhaps the most important. The SELECT statement 
is used to extract data from the database based on user defined criteria. This criterion applies to both columns and 
rows. The rows and columns are returned as a matrix and look very similar in structure to that of a spreadsheet. 
The returned values are also called the result set. 



Related Subject: Getting started with databases on the cheap - Given the importance of databases to most 
organizations, discussion of databases is a frequent topic in many of my classes. Once the student is exposed to a 
database management system and has an idea of some of the features and functions they provide, they will 
develop a much better understanding of databases. I'm often asked, "What is the best way for a new programmer 
to develop their expertise with databases?" Fortunately, there are a couple of products distributed as freeware 
and shareware which give you a great chance to experience an experiment with a robust database management 
system. One database which many students have felt was a good starting point is MySQL. MySQL is a free, open 
systems solution that can be downloaded from the mysql.com web site. It will have many if not all of the features 
and functions found on the larger more sophisticated databases like Oracle, Microsoft SQL Server, Informix and 
DB2. But, best of all, it is free! 



The SELECT keyword is used to start the statement but is frequently used with the FROM and WHERE clauses 
which define the data source (the FROM) of the query and the rows to be returned (with the WHERE clause). For 
example, look at the following SQL SELECT query: 

SELECT AUTHOR, ISBN, TITLE, COST FROM BOOKS ORDER BY COST; 

I have included screen shots from Microsoft Access database product showing the SQL command window and also 
the result set window with the data returned from the SQL select query. 

Following the SELECT keyword, we identify the columns we are interested in seeing in the result set. In this case, 
we would like our query to return to the columns associated with author, ISBN, title and cost. The FROM clause 
indicates which table these columns will come from. And this query, we have a table called mail list that holds the 
selected columns. Finally, we have an ORDER BY clause which specifies that we would like the result set to be 
sorted in descending order by cost. As I hope you can see, SQL offers an English like command language which can 
be used to provide criterion to extract information from database files. In this query, we are selecting information 
from a single table. It is also possible to join multiple tables so the query can involve the selection of rows and 
columns in criteria across multiple tables. 
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Related Subject: Query Generation Tools - The many programming language products, specifically, IVlicrosoft's 
Visual Studio product, has included within it and SQL query designer. It is now possible to construct SQL 
statements without having formal knowledge of the SQL keywords and syntax. The query designer, through its 
graphical interface, allows you to select the columns and rows you're interested in returning while the tool builds 
the appropriate SQL statements. 



SQL DATA MANIPULATION LANGUAGE BASICS 

SQL Data manipulation language implements file maintenance on databases. Data manipulation commands allow 
us to add, change and delete data from our database. These SQL commands can be typed at an SQL command 
prompt, or stored as a text file and executed as a script (much like PYTHON). SQL can also be embedded into other 
programming languages and sent to a database as part of the application logic. IVIany of you who will continue to 
study of programming will eventually learn how to embed SQL commands within your programs. Embedded SQL is 
a very effective way of taking advantage of the flexibility of application programming languages and combine it 
with the power of data manipulation available with SQL. 

INSERT 

The INSERT command allows the user to insert new rows into the database. For insertion to be successful the user 
must correctly issue the INSERT command and abide by any database constraints controlling how the database 
table can be updated. When using the INSERT command you must make sure that all constraints are followed a 
specially those which require a field to be not null or not empty (i.e. employee salary). In addition, there may also 
be rules regarding uniqueness which would prevent a row from being inserted into the database if a column value 
already existed in the database (i.e. social security number). In the following INSERT statement, a new employee 
record is being added to the database. The SSN column must be unique and the LASTNAME and FIRSTNAME fields 
are required and must be included in the INSERT command. 

INSERT INTO EMPLOYEE SSN, LASTNAME, FIRSTNAME, SALARY, ('98938503948', 'DOE', 'JANE', 100000); 

Programming Tip: Strings are identified in SQL was single quotes (i.e. 'sample string'). This is in contrast with most 
programming languages that specify strings inside double quotes (i.e. "sample string"). 

UPDATE 

The UPDATE command is associated with making changes existing database data. Like the INSERT command the 
UPDATE command identifies a table and columns to be updated and a where clause to identify the affected 
records. The following UPDATE command changes the existing salaries of employees in department and increased 
each employee salary by 10 per cent.. 

UPDATE EMPLOYEE SET SALARY = SALARY * 1.10 WHERE DEPT = 10; 



Programming Tip: SQL statements can also contain data base functions and arithmetic operators to manipulate or 
report database data. Database functions are typically database specific (Oracle versus MySQL versus MS-Access, 
etc.) but are similar are crossed the various databases (i.e. many databases have different functions to manipulate 
the formats of dates). The functions may have different names but the date formatting functions provide much the 
same features. 
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DELETE 



We've covered inserting and updating data so deleting data is left. Although leaving data in the database for 
historical analysis can be very important, there may still be times when data needs to be deleted from database 
tables. DML has a DELETE command to remove rows from the databases (columns can also be removed but this 
would affect all rows in the database where as the delete command only effects single rows). Below we 

DELETE the employee name John Doe from dept 112. 

DELETE FROM EMPLOYEE WHERE NAME = "JOHN DOE" AND DEPT = 112; 



Programming Note: Note that SQL also supports compound operators like AND, NOT and OR in SQL statements. 



Background Information: Using SQL with Other Programming Languages - The Microsoft family of programming 
languages all support ~ADO.NET. ~ADO.NET of represents a standard architecture for programming languages to 
interface with databases. The databases can range from Microsoft Access to a table stored in an Oracle database. 
Accessing database data from a Visual Studio programming language like Visual Basic is as easy as configuring a 
connection to the database and using wizards and built-in components to connect, navigate through the database 
and perform file maintenance (INSERT, UPDATE, DELETE). 



ROW PROCESSING WITH DATABASES 

Databases can use the same logic pattern to process rows in a table as text files use to process records. Not all data 
access is a record at a time. There will be situations where a block or rows will need to be returned from the 
database and have a program manipulate the all of the rows (i.e. a calculation) and then saved back to the 
database. The database row processing might start with a SQL SELECT command and end with a SQL UPDATE that 
commits the changes to the database. 

Status Check 

A SELECT statement is called a query. What does that mean in relationship to file maintenance? 
Name the SQL DML commands used to manipulate database data along with their function.? 



INTRODUCTION TO XML 



Over the last several years, there has been increased interest in XML (Extensible Markup Language). First and 
foremost because XML offers flexibility to send data from client to server over the Internet but XML is also 
increasingly becoming the standard for storing data on standalone computers. XML is a script language much like 
HTML. Instead of using tags to format data displayed in a browser, XML is used to describe and store data. It uses 
XML tags to define fields and column constraints (similar to a database) in a standardized formatting language that 
can be used across operating systems (similar to HTML). 

We can only give you a very basic exposure to XML and make you aware of its importance. Below, I have included 
data formatted in XML. Using XML tags looks far more complicated than it actually is and because of its 
widespread acceptance many products will produce XML files for you. The Microsoft application products are 
especially useful for creating and manipulating XML files. XML is an open standard that no one owns. As a result, 
there are numerous sources on the Internet to find out more about XML and tools to include XML as the data 
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storage format of your data. You can think of XML as another alternative to storing data aside from sequential text 
files or databases. 

THE APPLICATION OF XML - MICROSOFT PRODUCTS 

Microsoft Corporation in particular has made great strides with integrating XML into their existing programming 
languages and product lines. Their implementation of XML has enhanced options for both Internet and desktop 
programming. Below I have presented two scenarios that demonstrate how XML has enhanced programs running 
under Internet and Desktop platforms. 



SCENARIO ONE: XML IN USED IN INTERNET PROGRAMMING 

For Internet applications to truly replace desktop applications, Internet programs must have the ability to move 
data from client to server. It is not enough to be able to display pictures and multimedia via the browser but for 
Internet programming to support commerce a technology was needed be in place that would seamlessly and 
securely transmit data from the client's browser to the server commerce store. XML in combination with another 
Internet technology called SOAP (Simple Object Access Protocol) creates a digital envelope that securely contains 
data are formatted in XML. This digital envelope can flow seamlessly through the Internet and computer firewalls 
to Internet applications which can take that data and complete the processing connected with the data. 



SCENARIO TWO: XML IN USED IN TRADITIONAL COMPUTING 

In the area of traditional computing, Microsoft Corporation has successfully implemented XML as the core of its 
~ADO.NET database technology. By utilizing XML's ability to describe and hold data, database data can be moved 
from the data source (~MS-Access, Oracle, MS-SQL Server, etc.) to a location in memory so that database data can 
be manipulated in a disconnected environment where the original data source need not be effected unless the 
XML data contains changes that need to be applied to the original data source. Just as XML gives the Internet 
program more flexibility the XML data in an ~ADO.NET application can perform manipulations of database data 
that was unavailable in previous versions of ADO that did not utilize XML. 



Background Information: Impact of XML on the future on application programs - There's no question that the 
computer industry has embraced XML as the new standard for storing data. XML can easily be used on both 
desktop and Internet based applications. Because at its core is a markup language, it is flexible and can be used in a 
variety of applications, operating systems and a variety of industries. Microsoft for one, has placed a lot of 
emphasis and resources on exit mile and has incorporated exit mile technology within many of its office products. 
Microsoft has also made extensive use of XML in its programming products. XML sits at the center of Microsoft's 
database architecture via ~ADO.NET and on the Internet via ~ASP.NET. All of the Microsoft programming products 
have utilities and wizards to encourage the use of XML in program development. 



Status Check 

Why is XML and important technology for the Internet? 

How can XML benefit programs designed to work with data from other organizations? 



PUTTING IT TO USE 
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The intent of this section is to introduce the new programmer to standards and techniques frequently used by 
professional programmers. Topics in this section relate to concepts introduced in the chapter but with a more 
vocational or occupational focus for students considering a career in programming. 



CHAPTER REVIEW 



Chapter summary, highlights, key terms, short answer questions, quizzes and case studies to reinforce topics 
covered in this chapter. 

CHAPTER SUMMARY 

After finishing this chapter you should understand and in some cases, demonstrate the following: 

• Define a file and recognize terms and concepts associated with file processing. 

o Data persistence is a term used to define the ability of programs to save data and return to it 
reload that data at later date when the program is run again. 

o Back office operations are business applications which are typically involved with the processing 
of a large number of transactions against the master file. 

o Sequential file processing has come to mean the process of text files holding master and 
transaction file information organized as records where the records are process sequentially one 
after another. 

• Define a database and recognize terms and concepts associated with record processing. 

o Databases provide a popular mechanism for storing and retrieving data. 

o Databases offer Improvements of data accuracy, data security and speed of access over 
traditional file systems. 

o Databases also help reduce data redundancy data (typically found in traditional file systems) 
which can also be important in making sure that the data remains accurate. 

• Differentiate between reading and writing to files and databases. 

o File maintenance is defined as add, change and delete operations performed on data stored in 
files and databases. 

o We can read information from files or databases or we can write information to * Define XML 
and recognize terms and concepts associated with file processing. 

o XML provides the ability to use a standardized set of data definition tags to describe and store 
data. 

o XML tags to define fields and column constraints (similar to a database) in a standardized 
formatting language that can be used across operating systems. 

• Define Structure Query Language (SQL) and describe its importance to database processing. 

o SQL is an English like procedural language used to communicate with databases to exact and 
perform file maintenance. 
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o SQL Data manipulation language implements file maintenance on databases with SELECT, 
UPDATE, INSERT and DELETE commands. 

CHAPTER KEY TERMS 

Control Break Processing 
Data Manipulation Language 
Data Persistence 
Database Files 

Database Management Software 
File Maintenance 
Master File 
Read 

Record Layout 
Record Processing 
Secondary Storage Device 
Sequential Data Files 
Structured Query Language 
Two Phase Commit 
Transaction File 
Write 

XML (Extensible Markup Language) Files 
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PART 3 INTRODUCTION TO OBJECT ORIENTATED PROGRAMMING 



CHAPTER 8 LEARNING ABOUT CLASSES AND OBJECTS 



IN THIS CHAPTER, YOU WILL LEARN HOW TO: 



• Define and describe benefits of designing programs using object orientated design techniques. 

• Analyze tlie differences between structured programming techniques and object oriented programming 
techniques. 

• Define and apply the components of class objects to a business problem. 

• Demonstrate the design of logic and programming using Object Orientated Programming techniques. 

• Recognize OOP design and structures in an OOP program and define their role in a working program. 



INTRODUCTION TO OBJECT ORIENTATED PROGRAMMING 



With this chapter, we are starting a new section of the eBook and learning another approach to developing logic 
and programming. Structured programming techniques have stood as the staple of programming for more than 
thirty years. However, structured programming techniques have not changed much and there have been a number 
of advances in program development. The most significant advance has been approaches that have improved 
program source code reuse. One technology that has paved the way for code reuse is object oriented 
programming, Object Oriented Programming (OOP) was first implemented in a version of the C++ programming 
language called Smalltalk and then was made central to the Java programming language. Most recently it has been 
implemented across the Microsoft Visual Studio programming language. Most all of the programming languages 
used in business programming have implemented parts of OOP so that even languages that were originally 
designed for structured programming can also support code reuse. 

Our goal in this chapter is to concentrate on topics and concepts first rather than expecting you to create the code 
for class objects this soon in your instruction. This will allow us to focus on the fundamentals first. It is critically 
important that you understand the fundamentals. Object orientated programming is always a challenging topic 
and you will at first probably find it much more difficult than structured programming. With the concepts taught in 
this chapter, we will then move to chapter 9 where we will concentrate on learning how to build our own classes. 
In short, we learn about objects and how to use them in chapter 8 and how to create them in chapter 9. 



Object Oriented Programming - Object Oriented Programming (OOP) is a style of programming that identifies and 
groups variables and modules into class objects. The class object represents a "thing" like a customer, a purchase, 
a payment and expresses each in terms of their data (state) and modules (behavior). The class object is stored in a 
file where it can then be accessed by the programs logic and more important be reused by other programs. 
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THE WHY OF OOP? 



Before we learn the techniques necessary to program with objects, it is important to understand why OOP has 
become such an important part of application programming. The use of class objects has become a very important 
tool in the programmer's toolbox and understanding OOP may make the difference in securing that first 
programming position or promotion. 

Let us look at OOP from a very practical standpoint using a business example. Historically, computer software has 
always been a labor intensive activity. It takes many hours for programmers to develop high-quality and efficient 
software. Rush the development process and you can be assured that logic mistakes will prevail thus creating an 
unreliable program. Most companies have had problems dealing with a software development backlog. What this 
means is that the requests for new software outstretch the ability of the programming staff to create new 
programs and maintain existing software. Using existing structured programming techniques alone might extend 
an already overburdened programming staff or rush the process at the sacrifice of quality. 

Today, most companies use their computer systems for strategic advantage and competitiveness. If a company is 
not able to respond to its competition or to a market opportunity with new systems, it will suffer via lower profits, 
lost customers, or decreasing market share. The main challenge of most software development managers is to deal 
with the software development backlog. Any software development tools or techniques that would allow 
programmers to become more efficient and productive will always be seen as a great benefit since it can only help 
the company's ability to compete. With OOP, one of its main benefits is the ability of programmers to create 
snippets of code called class objects that can be reused across many applications. In short, these generic code 
snippets combine key variables and modules into containers called class objects so that they can be used in more 
than one program. 

This process is an extension of what we have already discussed in our chapter on modularization. It has been taken 
one step further by not only isolating modules but also the data associated with them and placed them in a 
separate file so they can be share by more than one program (and programmer). 
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A Class File 




A Class File representing a student called StudentClass 




Figure 1: A Class Object 



A BUSINESS EXAMPLE 

For example, let's say your organization sells automobiles. Maybe it is a car dealership. You most certainly will 
have customers. You have new customers and you'll have existing customers. You'll have customers w/ho buy 
trucks and you have customers who buy cars. You'll need to create programs that use customer data for the sales 
department, for the service department, and for the accounting department. For all customers, there is certain 
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customer data and modules that would be common to all applications that need to use or manipulate customer 
information. The information pertaining to customer name, customer address, the vehicle type purchased, vehicle 
information number, sales price of the vehicle, etc. would certainly be common to applications written for the 
accounting and sales departments. 

In addition to customer data, there are blocks of logic (modules are called methods by most OOP programming 
languages) that would also be the same from department to department and from application to application. 
Maybe an example of a customer module might be a block of logic which calculates the monthly payment, a late 
penalty, or loan balance. 

Programming Tip: When programming in OOP, modules are usually referred to as methods. 



A Class File representing a student called Customer.Class 



Class Data 

char customerName 
char customerStreet 
char customerCity 
char customerState 
char vehlclePurchased 
num VIN 
num salesPrice 



I Class Modules or Methods 
calclVlonthlyPayment 
calcLateFee 
calcLoanBalance 
monthlyStatement 



Figure 2: Graphic of Customer Class 

The programmers for this car dealership may write software exclusively for one department (maybe the Sales 
Department) or write programs for all the departments (Accounts Receivable, Marketing, Service, etc.). If the basic 
data and logic for the customer is created in a way that it can be used in multiple applications then this would save 
time in developing and maintaining existing applications. There's an old expression which talks about not 
"reinventing the wheel." Reinventing the wheel has come to mean inventing the solution to a task when the task 
has already been done by someone else. 
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In the context of programming, it would describe the situation where two programmers need logic to calculate late 
payment fees and they both independently develop their own logic instead of sharing. If the logic exists already 
there's no need to recreate it. It is much more efficient for one class object to be created to represent a customer 
data and logic, then to have each programmer create a unique data and logic definition for each program that 
works with customer information. The duplication can actually lead to quality problems since it is possible for both 
programmers to create a solution based on their interpretation. As is often the case, two people can see the same 
thing and still come up with different solutions. This could create problems if the answer is also different. 

OOP... THE BENEFITS 

As the previous example illustrates, the most significant benefit of OOP is code reuse. The ability to create program 
logic once and to reuse it over and over again is the primary advantage of OOP. A secondary benefit relates to 
logic/program maintenance. Taking our analogy of one class shared by many programs, it now becomes possible to 
make program changes or program fixes in one location (a class file) and have those shared fixes or changes ripple 
to all affected applications. 

If you think back to the problems that were encountered trying to update programs to accommodate year 2000 
calculations, how much easier would it have been to maintain in the affected programs if they used the same date 
processing logic via a class file. The Y2K problem would've been much easier to resolve if more applications have 
been written using class objects. 



Key Concept: Code reusability is the most important benefit of object orientated programming. This improves the 
maintainability of the program and reduces development time by using proven high quality code. 



AS COMPARED TO STRUCTURED PROGRAMMING 

I would like to start our learning of OOP by revisiting and reviewing structured programming techniques. Now it is 
important to understand that structured programming was developed to reduce what we have talked about earlier 
poorly formatted programming logic. From a historical perspective, structured programming was developed before 
OOP. In a time when programming was just beginning to develop disciplines of standardization and rigor, 
structured programming gave the profession a set of proven repeatable programming standards. Programming 
standards are also part of OOP. As we create our class files, we will need to document the variables and modules 
that are common to that class. The creation of class variables along with many of the rules regarding naming 
conventions and configuration are identical to rules used in structured programming. The modules that we created 
in structured programming still have the same function as classes in that they organize our logic into smaller more 
defined pieces. 

So what is the difference? I often like to describe a class object as structured programming components on 
steroids. In other words, in our structured programming pseudo code the application acted as the container for 
our variables and modules. 

With structured programming, everything needed for the program to execute was included inside the application. 
With a class object, we have essentially built a container (another file) that contains variables and modules unique 
to a particular "thing" (like a Customer) that is contained in our program. The class objects are included in 
applications along with other logic statements and identifiers to make up our program. Instead of only calling 
modules and variables directly from the application like we did in our structured programming applications, we will 
now call them from the Class Object (another file). Our programs become collections of class files connected to 
work together for our program solution. 
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Related Subject: To OOP or not to OOP, that is the question...- A question needs to be asl<ed. Since both structured 
programming and object oriented design both produce effective solutions, it there a situation where I might not 
what to use OOP for my program design? One situation where the benefits might be limited is the program you 
write once for yourself never to be worked on again. This program would probably not be one that would be 
reused and therefore maybe not a good candidate for OOP. Funny thing though is that programs like this have a 
way of showing up again or in other programs so maybe OOP might be the better way. Any thoughts? 

We will make our calls to class files using the dot notation standard. Dot notation means that we will call class 
members (variables and methods) with the class name followed by a dot and then a class member name of that 
class (i.e. Customer. customerName would be the variable holding customer name and Customer. curBal() would be 
the method that calculates the customers current account balance). In pseudo code, a print statement using dot 
notation calling a class variable and module would look like this: 

print custommer.customerName 

Class object: A class object acts like a blueprint to describe a "thing" we are using in our program. For example, 
this "thing" might be a product or a customer. The class defines the data (i.e. customer name, address, current 
balance, etc.) associated with each "thing" along with any modules associated with the class (calculated customer 
balance, calculated month purchases, etc.). 



Class member: classes consist of variables and modules (also called methods in class files). These variables and 
methods are said to be members of the class. 



Dot notation: when referring to a specific member of a class you identify it in logic and your program by using dot 
notation. This consists of the class name, a dot (period) and then the member name (i.e. Customer.customerName 
to identify the customer name data in the customer class file). 

As you can see, when we talk about classes, we are still using structured programming as the foundation. I say this 
because as you learn more about OOP and its techniques, you will find OOP can be somewhat complicated. You 
should remember that despite the complexity, OOP maps back to structured programming which has historically 
been easier for students to understand. You should also understand it is possible to build on the concepts learned 
in structured programming to understand object orientated programming. Both approaches follow the same 
programming process learned in chapter one (fact finding, conceptual design, detailed design, implementation and 
maintenance). 

Logic Tip: Programming process stays the same whether you are developing structured programs or object 
oriented programs. This is explained in greater detail when you get to the section of the chapter that covers 
encapsulation. 
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Figure 3: Graphical representation of a program that uses classes. 
Status Check 

What the business benefits are for object orientated programming? 
How does a class object support code reuse? 

FIRST LOOKS: USING PSEUDO CODE TO MODEL OOP LOGIC 

Let's look at an example. We are going to create class that holds checkbook information. It will have data variables 
for deposits, checks and balance and the curBal method to calculate a current balance (that is stored in the 
balance variable and printed to the screen) and a toString method to print out Information on the class data. Our 
program will instantiate the class as cb and store values to the deposit and checks variables (100 + 100 to deposits 
and 100 to checks). It will then call the curBal method to summarize deposits and checks and display the balance to 
the screen. 

The following pseudo code has an application program calling a class object to accomplish its task. The application 
is a checkbook balance program. It is using a class called checkbook and instantiating it as an object called cb. Just 
like a variable needs to be defined before it is used. Classes need to be instantiated to inform the computer that 
memory needs to be allocated to store the contents of the classes' members. The cb object will store a deposit and 
check value that when calculated via a class method called CurBal will return the checkbook balance. 
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Instantiating (instantiation) - Instantiating is very similar to declaring a variable. Instead of just a variable. 
Instantiating declares an object and all of its members and puts It in memory. 

start 

cb = CheckBookO 

cb. deposits = 100 
print "Banking Summary" 

cb. deposits = (100 + cb. deposits) 
cb. checks = 100 

cb.curBalO 

end 

class CheckBook: 

deposits equals 0 
checks equals 0 
balance equals 0 

curBalQ 

balance = deposits - checks 

print "Deposits $" + deposits + " Checks $" + checks + 
" Balance = $" + balance 

return 
toStrlngO 

print "Deposits $" + deposits + " Checks $" + checks + " Balance = $" + 

balance 

return 

End Class 

- Here we Instantiate our class object so that operating system Is notified that memory needs to be allocated. We 
will refer to the class object by the name we assigned it cb. The naming of class objects Is similar to variables in 
that It Is assigned by the programmer. 

- In this statement, we are assigning a variable to the deposits member of the class object. 

- In this statement, we are returning the current value stored In the deposits member, adding 100 to It and 
restoring It back Into the deposits member. 

- Here we are called the ~curBal method to execute a module. 

- This marks the start of the class module. 

- By standard, data variables are assigned at the beginning of the class file. 

- Class methods are historically defined at the end of the class. Here we have two methods called ~curBal and 
toString. 
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The program moves back and forth running logic from the program and then the class until all of the program logic 
has been executed. 



OOP TERMS, DEFINITIONS AND FUNDAMENTAL CONCEPTS 

It is difficult to go right into modeling logic in OOP like we with did with structured programming. OOP is not 
learned sequentially but instead more of a circular approach. In other words, you learn a little about OOP and 
return to it and learn a little more. In this chapter, we will start with and introduction and then return to the logic 
and programs again to learn a little more. First we will review important terms, definitions and concepts associated 
with OOP. Some of these terms and concepts have already been introduced but we will address them together in 
this section of the chapter. 

Related Subject: A light bulb event - OOP is always a complicated topic for programming students. I tell all my 
students the same thing. OOP is not a spectator sport. You must get your hands dirty by looking at OOP examples. 
It will certainly not come without some research and effort. Unlike learning to walk, OOP is not one of those 
instinctive things we will learn with time. It takes a lot of effort reading through the code line by line until finally, 
the light bulb event. That time when everything comes together and what was once very complicated becomes not 
really very complicated at all. This is the "light bulb event" you will have when OOP finally makes complete sense. 



UNDERSTANDING ABSTRACTION 

For many, the concept of abstraction is justification itself for choosing OOP over traditional programming 
approaches like a structured programming. Using the concept of abstraction, means the user of a class object only 
needs to understand how to communicate with the object. In other words, the class object needs to know how to 
send messages and how to interpret the messages that are sent. This sounds more complicated than it actually is. 

For example, we all know how to use a telephone. We know that if we hit the keys on the keypad in a pattern that 
represents the parties' telephone number we wish to communicate with, that the phone switch owned by the 
telephone company will facilitate connecting us to the party we're calling. Do we need to know any of the specifics 
about the telephone equipment or how this happens? Do we know the properties of the plastic used in the hand 
set? Do we understand the electrical schematic which represents how the electronics of the telephone works? Do 
we understand how a telephone company takes the telephone number we entered and switch that to the 
appropriate party? The answer all these questions is no. This is abstraction or not having to understand the details 
of the thing we are using but just how to communicate with it. 

All we need to know to use the telephone is how to send it messages. We need to know that by pressing the 
keypad (sending an input message) we provide input to the system that is going to connect our call (processing) 
and we know that once the call is picked up, our voice will be transmitted through the speaker (output) in the 
headset. Many will tell you that abstraction is the principal benefit behind OOP. They will tell you that our brain 
uses abstraction every second of the day to interact with things in our environment. Many of these things we may 
not understand but we do know how to communicate with them. It is because of the concept of abstraction that 
many would argue that OOP is the most efficient way of creating program logic. 

Abstraction: The concept of abstraction describes how we interact with things we may not understand the details 
of. For example, we may not understand the internal specifics of a computer but we know that they keyboard will 
accept our commands (input messages) and the screen will display (output) the computers response to our 
requests. We may not know anything about the electronics of the computer but that is not important in using it. 
We just need to know how to send it messages and communicate it with it. 
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Key Concept: Abstraction was important in module design (from our structured programming chapter on 
modularization) and it is even more critical in class design. 



REUSE EXPLAINED 

Simply stated code reuse is the ability to reuse program variables and modules. Reusable logic is created in a 
generic fashion to improve its ability to be used in a number of programs. The class object is the principal reuse 
mechanism by bundling variables and logic in a class file. 

CLASSES AND OBJECTS DEFINED 

The terms classes and objects are often used synonymously but are actually different. The file that contains the 
definition of variables and modules logic is called a class file. It is often times compared to a blueprint or to a 
cookie cutter. In other words, it is a description of something that has yet to be fully defined. 

A blueprint is a technical drawing of a house and exists only on paper. The builder uses the blueprint and by adding 
labor and materials will build the house. In addition, like a class a blueprint can be used to create many houses but 
each house will have its own personality through paint color, carpeting etc.). If I use the Customer class to create 
five different customer objects, they will all be different with each object having their own personality via the 
customer data stored within them (i.e. one might have a customer name of John Doe and another might have a 
name of Jane Doe, etc.). 

Class files have also been compared to a cookie cutter. When we make cookies, we use a cookie cutter that stamps 
out of the dough the shape of the cookie. We add sprinkles, frosting and candies to individualize each cookie. The 
Class is the cookie cutter. When the class is instantiated (a cookie cutter stamping the cookie out of the dough) 
into an class object it is just cookie dough. We next decorate the cookie with frosting, candies, etc. so that it 
becomes different than the other cookies. 

In our example above, we use the Checkbook class to stamp out a new object called cb. We add the deposits and 
checks to the cb object that will make it unique to a specific customer. Just like we would take an undecorated 
cookie and decorate it to make a unique cookie. 

When our program instantiates the object, it creates the object (like it did when we created cb above) and the 
computer allocates an area in its memory to store that object. If we create another Checkbook object (maybe 
called cb2), it would have its memory space also. 



Programming Tip: Like variables names, class object names must be unique in our program. We can create 
multiple instances of the same object but each must have their own variable name. If the names are not unique, 
the compiler will return and error. 



MORE OOP TERMINOLOGY 

A class member could be a variable or module (called methods in most OOP computer programming languages) 
that is used to store information or hold a module related to the class. 

Dot notation is a syntax technique that allows the programmer to use the left side of the "." to identify the class 
name in the right side of the "." to identify the class member. This allows for the use of multiple class objects 
within the same program and illustrates how using class members is like calling code stored in a container outside 
the program. 
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Programming Tip: The dot notation is almost universal across programming languages. Many programming IDE's 
will even have pop up lists that list the members of the class so the programmer does not have to know all the 
members included in the class. 



ENCAPSULATION DEFINED 



Encapsulation is also referred to as "information hiding." Information hiding is a necessary component to support 
and facilitate code reuse. Encapsulation is implemented by using variable scope modifiers (Private and Public 
access are covered in detail in chapter 9) to ensure that class variables are only accessed an updated via public 
scoped modules contained within the class (the details are hidden or what is called information hiding). 
Encapsulation is the primary mechanism that facilitates abstraction and promotes code reuse. 



Background Information: What happened to flow charts? - It has been some time since we displayed or discussed 
a flowchart. If you remember back to early discussions about flowcharts they have their pluses and minuses. One 
of the pluses is that it's an easy way to show non-technical users the flow of program logic. One of the minuses is 
that flowcharts can be little unwieldy woodworking with larger programs. When it comes to object oriented 
programming we will start to use a new modeling process called UML (unified modeling language). UML has within 
it graphical models which very much resemble flowcharts. It is also possible to incorporate flowcharts with UML. 
Since all logic models essentially perform the same function of providing a perfect world solution to a problem, 
mixing and matching modeling processes can usually be combined if the end product produces a better logic 
model. UML will be covered in chapter 10. 



INHERITANCE EXPLAINED 

Another characteristic of OOP is the ability of classes to inherit other classes. When a class is inherited that class 
gets all of the members of the class it inherited. Inheritance is a feature that helps facilitate code reuse. Simply 
stated, inheritance means to Class much the same as Inheritance would mean in conversation. When you inherit 
something from someone you are receiving something from them that is now yours. When a class file inherits from 
another class it inherits all of its members (variables and methods). Different languages use different terms to 
categorize the two parties in the inheritance. Java for example uses subclass to identify the class that is inheriting 
members and superclass to identify the class that is giving its members. 



Programming Tip: Subclasses - This is somewhat of a misnomer since in all cases the subclass will contain all the 
superclass members plus some of its own. Therefore the subclass is in reality or powerful than the superclass. 



UNDERSTANDING POLYMORPHISM 

Polymorphism translates from its Greek root as "many forms." Polymorphism is an extremely powerful feature 
that allows the programmer to create methods that have the same name but have different parameters. This 
simplifies the complexity of the program and again provides for a more effective way of reusing modules. For 
example, the formula for the area of a rectangle is length times width. As you remember from our earlier 
discussion of data types, we can express a number with or without a decimal. Polymorphism allows us to create 
two methods with the same name but with different data types for the parameters. One version would accept two 
integer numbers and one would accept two double numbers. The program would determine which method to use 
at run-time based on the numbers inputted. This ability to decide the appropriate method at runtime based on the 
methods parameters is also called dynamic binding and a characteristic of polymorphism. This is a very powerful 
programming tool available with OOP. 



Key Concept: Understanding abstraction, polymorphism, inheritance and encapsulation are very important in 
learning OOP. OOP can be a difficult task and one where you must understand the underlying foundation principles 
to correctly use and design class objects. 
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status Check 

How is using a computer an example of abstraction? 

What is the difference between polymorphism, inheritance and encapsulation? 



USING CLASSES AND OBJECTS 



It is time to take the terms will learned and the sample code which I have placed below and breakdown the 
individual sections of the pseudo code to identify the key components of an object orientated program. 

We need a start by are looking at structured pseudo code. Again we're using Python to with our pseudo code 
because Python allows us to validate logic we are complete. Just like modules (Python will called modules 
functions) Python requires that we identify all Classes before they are used. As a result, my class called Checkbook 
is the first section of my program. The class called checkbook contains two major sections. 

By convention, the first section of the class will contain all instance variables. We have three instance variables. 
They're called instance variables because these variables will occur in every class instance we create. For this 
program, is these variables are called deposits, checks, and balance. They observe the same rules as the variables 
we described with structured programming in that they have a name and the data type. The naming conventions 
for variables also follow the same basic rules as the variables we used in structured programming. 

The second section of the class file contains the methods. A method is a function or module that is owned by the 
class. Depending on the programming language you're using, method, function, module, subroutine may all be 
used interchangeably. These methods would be very similar to modules we created in structured programming 
and also except parameters and return values like the modules we used earlier. 

start 

cb = CheckBookO 

cb. deposits = 100 

print "Banking Summary" 

cb. deposits = (100 + cb. deposits) 

cb. checks = 100 

cb.CurBalO 

end 

class CheckBook: 
first section of class file containing instance variables 
deposits equals 0 
checks equals 0 
balance equals 0 
second section of class filecontaining class methods 
CurBalQ 

balance = deposits - checks 

print "Deposits $" + deposits + " Checks $" + checks + 
" Balance = $" + balance 

return 
toStringO 

print "Deposits $" + deposits + " Checks $" + checks + " Balance = $" + 

balance 
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return 

End Class 



- Instance variables 

- Class methods 

OOP IN ACTION: PARTS OF THE CLASS 

As been mentioned earlier, the parts of the class are called class members. They can be divided into two types of 
members. Object identifiers and object methods and reviewed in detail below. 

OBJECT IDENTIFIERS 

We have three identifiers to discuss in regards to classes. We can define class constants that work essentially the 
same as constants in structured programming logic except that class constants are defined within a class file. The 
second type of identifier can be defined as instance variables or class variables. They both can be updated can 
modified but they do have different purposes. 

INSTANCE VARIABLES 

Instance variables get their name because for every class that is instantiated an instance variable is created. If you 
instantiate five objects from the same class, each object will have their own set of instance variables. Instance 
variables are typically the first members identified in a class. 

class CheckBook: 

# Instance variables 

self. deposits = 0 # initialize deposits instance variable to 0 
self.checks = 0 # initialize checks instance variable to 0 
self, balance = 0 # initialize balance instance variable to 0 

- Here we use the PYTHON init to describe and initialize instance variables. 
CLASS VARIABLES 



Class variables are variables which are shared across all its instantiated classes. For example, maybe a class 
contains a counter class variable that holds the number of classes that have been instantiated. With a class 
variable, all of the class objects would have access to the same class variable and could update or use the value in 
their logic. Class variables are identified with modifiers. In Java for example, you use the static modifier to 
designate a variable as a class variable. 

private static counter; 



Programming Tip: Different programming languages use different approaches and modifiers to identify instance 
and class variables. Some languages (like VB.Net) use fairly obvious modifiers like const to identify the member 
and others (like Java) use modifiers like static that are not as obvious and may require closer investigation. 
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OBJECT METHODS 



We have dedicated a large portion of this program to modules. With class files, we store our modules inside the 
class as methods. Like the modules we discuss earlier, the methods in classes can accept parameters and return 
values. Like variables, when we call a method owned by a class from the program we must qualify the name of the 
method with the object variable and a dot (dot notation). 

Methods - Modules implemented into a class are called methods. Like modules, methods can accept parameters 
and optionally return a value at the conclusion of the module. 

CurBal(self) 

balance = deposits - checks 

print "Deposits $" + deposits + " Checks $" + checks + 
" Balance = $" + balance 

return 
toString(self) 

print "Deposits $" + deposits + " Checks $" + checks + " Balance = $" + balance 
return 

- These PYTHON methods are defined with public access and can be called by the main program to access class 
variables or run class modules. 



Logic Tip: Class methods are the functional equivalent of the modules we have discussed in earlier chapters. They 
contain a module header and program statements inside the body of the method. 

INSTANTIATING THE CLASS OBJECT IN THE APPLICATION 

If you remember the structured programming programs shown earlier, the programs contained all of the 
statements necessary for the program to execute. In my OOP version, the main program has fewer statements and 
calls and the class object to perform much of the programs logic. 

Below, the class file is inside the source file but outside the main body of our pseudo code application. The very 
first statement of that main body identifies an object variable called cb. When we instantiate the Checkbook class 
it will map of a block of memory which represents the members of the Checkbook class which we will call using the 
object variable cb. This block of memory will hold both the instance variables and also the class methods. 
Whenever we wish to communicate to one of these variables or methods we use a dot notation to call out that 
member. 
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Figure 4: Instantiating a class from file to memory. 



Each time we create an object variable we can instantiate a different class object and create in a different block of 
memory. For this program, we use only one class object called cb. 



#start of program 
cb = CheckBookO 



Status Check 

Differentiate between a class and instance variable? 
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How is a method similar to a module? 



THE MAIN LOGIC 



In my sample program, I set the initial value of deposits to equal 100 and then I double deposits by adding 100 to 
the current value of deposits (100) for a total of 200. I set the checl<s instance variable to be 100. Finally, I call the 
CurBal method to return the difference betw/een the values stored in deposits less the value stored in checks. 

cb. deposits = 100 

print "Banl<ing Summary" 

cb. deposits = (100 + cb. deposits) 

cb. checks = 100 

cb.CurBalO 

- Note the dot that separates the object name and instance variable 



CACTUS CASE STUDY 



In the spirit of this chapter's goal of introducing OOP only, we will not be creating our own class object but instead 
we will be using one that was created by another programmer. Since the Chavez sisters are implementing its audio 
book ordering system over the Internet, it will be necessary for the application to accept credit card payments 
online. For the payment to be processed correctly, certain information has to be captured from the web page and 
then sent as a web service method call on the credit card company's web site. 

A web service is a class file is implemented on another computer and accessor ball over the Internet. Typically, 
data is sent as a method call to the web service class and information regarding the acceptance or rejection of the 
payment is sent back to the website where the customer will be notified of the transaction status. 

You'll be creating a new logic model for this application. At this point, you are mostly interested in testing out your 
ability to access the service, pass the information correctly and an acceptance or rejection notification from the 
credit card companies web server. The information collected should be credit card name, credit card number, 
charge amount and credit card expiration date. Below is class information and pseudo code. In most cases, you will 
not have the pseudo code but instead only the method header information. For learning purposes, I have included 
some pseudo code for you to look at to help understand the program. 

Web Service Class Object with payment method 

class WebPayment 

payment(customerName, customerCCNumber, expDate, Amount) 
open CustomerFile 
while not End-Of-File 

read custID, custCC, custExpdate 

if customerName = custID and 
custCC = customerCCNumber and 
custExpDate = expDate then 
status = "approved" 

else 

status = "rejected" 
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return status 
end class 



- The WebPayment class contains only one method called payment. This method accepts for character parameters 
and returns a character value of either "approved" or "rejected." 

- The payment method opens credit card numbers. 

- An if statement is used to decide whether the information passed to the method exists inside the credit card 
member file. If the information is contained within that file the method returns the value "approved" otherwise it 
will return a value of "rejected." 

CASE STUDY TASKS: 

• Use the WebPayment class to call the payment method 

• provide the payment method with the required parameters and print the returned values 

• Design the case study first in pseudo code and then code. 



PSEUDO CODE SOLUTION 

Note: Again, I have left off the robust data validation you would normally find in your program. We are focusing 
using a class and calling its members in this example. 

Driver class 
start 

declare Variables 

WebService myPayment 
custName = input("Enter Customer Name ") 
custCreditCard = input{"Enter Customer Card Number") 
custExpDate = input("Enter Card Expiration Date ") 
custAmount = input("Enter Purchase Amount ") 

print "Purchase Status" 

print myPayment.payment(custName, custCardNumber, custExpDate , custAmount) 
print "Thank you for your Business!? 

end 

- Declare program variables including a variable to point to the WebService class. 

- The main program with logic 

- Call to payment method of WebService class with program parameters. 
ccfile.txt 



Gary Marrer 1111111111111 12012006 
Jane Doe 2222222222222 06012006 
John Doe 3333333333333 12152007 
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PUTTING IT TO USE 



The intent of this section is to introduce the new programmer to standards and techniques frequently used by 
professional programmers. Topics in this section relate to concepts introduced in the chapter but with a more 
vocational or occupational focus for students considering a career In programming. 



CHAPTER REVIEW 



Chapter summary, highlights, key terms, short answer questions, quizzes and case studies to reinforce topics 
covered In this chapter. 

CHAPTER SUMMARY 

After finishing this chapter you should understand and In some cases, demonstrate the following topics: 



Define describe benefits of designing programs using object orientated design techniques. 

o One of the main benefits of OOP Is It's the ability to create snippets of code called class objects 
that can be reused across many applications. 

o These generic code snippets combine key variables and methods into containers called class 
objects so that they can be used in more than one program. 

Analyze the differences between structure programming techniques and object oriented programming 
techniques. 

o Structured programming was developed before OOP but most new programming improvement is 
derived from for OOP. 

o OOP was developed after structured programming and borrows heavily from Its principals of 
modularization and abstraction. So much so that understanding structured programming 
techniques will help in understanding object orientated techniques. 

o The creation of class Instance variables along with many of the rules regarding naming 
conventions and configuration are very similar to rules used In structured programming. 

Recognize OOP design and structures in an OOP program and define their role In a working OOP program 
(the role of a maintenance programmer). 

o Classes comprise the main building block of object or need programming. Classes represent 
things, ideas and places by holding data (also called properties and attributes) and methods 
related to the things represented In classes. 

o Object or need programming uses concepts like encapsulation, polymorphism and inheritance to 
provide code reuse at both design time and at runtime. 
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CHAPTER KEY TERMS 



Abstraction 
Class Member 
Class Object 
Class Variables 
Code Reuse 
Dot Notation 
Encapsulation 
Inheritance 
Instance Variables 
Instantiate 
Methods 

Object Oriented Programming (OOP) 
Polymorphism 
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PART 3 INTRODUCTION TO OBJECT ORIENTATED PROGRAMMING 



CHAPTER 9 OBJECT ORIENTATED PROGRAMMING CONTINUED 



IN THIS CHAPTER, YOU WILL LEARN HOW TO: 



• Explain and develop custom class objects. 

• Recognize and define concepts of encapsulation as it pertains to information liiding, ode reuse and 
accessor and mutator methods. 

• Recognize and define concepts of polymorphism by overriding and overloading class methods. 

• Recognize and define concepts of inheritance along with concrete and abstract classes. 

• Apply driver, custom and built in classes into programs 

• Describe the programming process as it relates to object oriented programming. 



OBJECT ORIENTATED PROGRAMMING CONTINUED AND EXPANDED 



In this chapter, we will expand upon what we have learned about object oriented programming. In chapter eight, 
we covered general OOP vocabulary along with fundamental concepts. Most of our previous discussion of object 
oriented programming included an existing class that was incorporated in our program. Although you'll probably 
use mostly preexisting classes in your program development, there will also be many occasions where you'll need 
to design your own class files. We will call the classes we create, custom classes since they are being designed 
based on a requirement we have in our program and will contain data and methods of our design. 

Learning about creating custom classes can be a lot like learning a foreign language. Like with a foreign language, 
many times it's easier to read the language then it is to speak it. Using classes works much the same way. It is 
much easier to read and use a class that's been designed for you that it is to create one from scratch. This is not 
without precedence and we've seen this in earlier chapters. 



Programming Tip -Programs and general are always easier to understand if the source code has been created for 
you versus having to create the source code from scratch. 



Along with the task of creating our own class objects, we will also go deeper into encapsulation, polymorphism and 
inheritance. Unlike structured programming where we could focus more on logic and pseudo code, object oriented 
programming requires you understand concepts fundamental to code reuse and abstraction. In this chapter, we 
will continue with more examples and discussion to build on this. 

INHERITANCE EXPANDED 
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From the last chapter, you will remember that Inheritance can be defined as the ability of a child class to inherit 
data and methods from its parent. Because of this relationship, the children always have more class members than 
their parents and therefore in effect are more powerful than their parents. Inheritance can be a very powerful 
method of implementing code reuse by allowing data and methods to be shared generically across several child 
classes. 

As a new programmer, it may be hard to see the importance of inheritance in code reuse at first glance. One of the 
most powerful statements about the power of code reuse provided by inheritance can be found in documentation 
of classes. Most programming languages (I will use Java in my example) come with extensive libraries of classes 
ready for program use. One of the pieces of information supplied with the documentation is the name of each 
class inherited by that class. As you look through the classes, you will be hard pressed to find and example where 
one of these classes does not inherit two or more classes. The professional OOP programmer needs to correctly 
apply inheritance to his classes and fully understand how to apply techniques of code reuse with inheritance. 

In this chapter, most of our examples will surround the creation of a Student class used to represent the data and 
the methods associated with a college student. We will create several programs which will store and retrieve 
Student class data along with calling methods from the student class. The Student class was chosen because it's 
something that everyone can relate to and lends itself well to showing examples of encapsulation, inheritance and 
polymorphism. 

DESIGNING CLASSES TO FACILITATE INHERITANCE 

One of the first activities necessary in developing our Student class is to determine if any part of that class could be 
inherited from a parent class. If we think about a typical student for just a second, there are some attributes of 
Student which are shared by all students. A student has a name, a place of residence, a date of birth, a GPA, a 
major (among other things). If we were writing programs for a college or university, it might also be helpful to look 
at some other classes that will also be used with the Student class. A Faculty member and college President might 
also be made into classes and are also likely to be used with programs that use the Student class. The Faculty class 
shares many of same attributes and for that matter so does a college president. Do not both the Faculty member 
and President also have a name, a place of residence and a date of birth? If we were to create a class for each of 
these three "things", we would find that despite each being different that they all could belong to another class 
called Person if Person contained a name, a place of residence and a date of birth. Therefore, we should be able to 
create a parent class called Person that contains the name, residence and date of birth and then inherit that class 
into child classes that would reflect a Student, a Faculty member and a college President. 

This would take care of any data that we shared across these classes but what about methods. Are there any 
actions that could be described as methods, in the person class and inherited by the student, faculty and president 
class? In this case, methods to be shared by these child classes may not be as easy to identify. There is one method 
that is common to most classes called the toStringO method. The toStringO method is special in that returns a 
string value describing the class. It is text that the class developer has determined to describe the class.. In this 
case, the toStringO method will return the person's name, their residence and their date of birth as a string. 



Programming Tip: Most class objects will have a toStringO method defined. This is standard across object 
orientated programming languages. toStringO is to be used as a helper method to return data as a string that can 
be displayed by the programmer. You can use this method as the programmer to help display information on the 
class or if the situation arises include it as part of your program. 



THE PARENT CLASS 
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The parent class (also known as the superclass and base class) contains data and methods which will be inherited 
by the child class. It's important that this class remains as generic is possible to be inherited by a large number of 
child classes. If the members of this class become too specific, the classes' ability to contain reusable code will be 
diminished. For example, we might thing that since we have more students than faculty members that more 
student data should be placed in the Person class. We might be inclined to add GPA to the Person class. If this was 
done the Faculty and President class could no longer inherit person since GPA data is not needed in their classes. 
Examine the pseudo code below and see the data and methods associated with a class named Person. 

class person 

char name 
char street 
char city 
char state 
char zip 

char DateOfBlrth 

toStringO 

char outString 

outString = name + "show lives at" street + city + state + 
" and born on" + DateOf Birth 

return 
end class 

- The start of the parent class instance variables 



- The start of parent class methods. 

This person class contains a number of data elements that can easily be shared and a method that can generically 
provide a method to display class data. Are there more data attributes and methods that might also be added to 
person and not limit its ability to act as a parent class? Absolutely, but we are going to keep our class files smaller 
for learning purposes. 

Parent and Child classes - With inheritance, one class acts as the parent and gives its class members to its children. 
The parent class and child class are referred to by different names in different languages. The parent class is called 
superclass and the child is called the subclass in Java. In Visual Basic. Net, the parent class is called the base class 
and the child class is called the derived class. 



Programming Tip - A parent class can have several child classes. In our example, person has child classes of 
student, faculty and president. Child classes could also have their own child classes. Student might have child 
classes of inStateStudent and outOfStateStudent. 

THE CHILD CLASS 

The first thing you'll notice in a child class (also known as subclass and derived class) is that included in the class 
statement will be a reference to the inherited parent class. Different languages have different firms to designate 
the inheritance. We will use Java keyword extends and are pseudo code examples. 
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class Student extends Person 
num gpa 
char major 
num totalCredits 
char studentID 
DeansListO 

status = "false" 
if gpa > 3.25 then 

status = true 

else 

status = false 

return status 
- Extends identifies the parent being inherited. 

With this child class, we inherited all of what was included in our parent plus I have added four new data elements 
and one new method. Since the child has these additional members, it is said that child will always be more 
functional than the parent. 



Ctessea can be a child to one class but 
also be a parent to other classes. 


Parent A 









Child lo Parent A 



Child tP Parent A 
Parent B * 



Child to Parent B 



Child to Parent B 



Figure 1: Parent - Child relationship 
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If we were to take this example one step further in use our parent person class with Faculty, you will see how the 
Person class can also be used to build a class object called Faculty. Below I have created a Faculty class that 
extends person. 

class Faculty extends Person 
num dept 
char officeLocation 
char credentials 
char deptChair 
FacultylnfoO 

char outString 
status = super.toStringO + officeLocation + dept 
credentials 

return status 
end class 

- Many times with creating a method you might want to use a method from the parent inside a method defined on 
the child. I am using the super keyword (this is used in Java) to indicate I would like to take the return value of the 
parents toStringO methods and add to it data fields contained in the child record. 

Status Check 

Can a child class have its own children? If so, why would this be useful? 
What is the difference between a base class and a superclass? 

MORE ON POLYMORPHISM 



Polymorphism can be a very broad topic in object orientated programming. In this eBook, we will focus our 
discussion of polymorphism on how it affects methods. The advantages to the programmer who uses 
polymorphism might be subtle. It is important to take the time to work with overloading and overriding methods 
to fully appreciate how polymorphism makes programs more powerful and flexible. Since polymorphism allows 
different forms of the same method to be included inside class files, it is now possible to invoke methods at 
runtime based on parameters or child classes' instantiated. This is also called dynamic binding and in this section of 
the chapter we will explain on hold this is implemented. 

OVERLOADING METHODS 

The overloading of methods is a technique that is not unique to object oriented programming. Many programming 
languages allow the programmer to create different modules with the same name providing that the modules 
have a different input parameter list. As we start to implement both polymorphism and encapsulation, the 
programmer has to pay special attention to what is called the method header. The method header typically 
contains the method scope modifier, the method name, the data type of the returned value in a parameter list 
indicating if one or more values will be passed into the method. In the case of overloading, and overloaded 
method is one which has the same name but a different input parameter list. Maybe one of the best examples of 
this behavior can be demonstrated in the calculation of the area of a rectangle. The area of our rectangle is 
calculated by multiplying the length times the width. A simple module to create unless the data being passed to 
the method needs to accept a different number of parameters with the parameters having different data types. 

Unlike pseudo-code and PYTHON which has only one data type to represent numbers, most programming 
languages actually have several data types that support everything from simple integers to complex decimal 
numbers. As a result, it is entirely possible that our rectangle formula may require two integers, two decimal 
numbers, one decimal and one integer, or one integer and one decimal as input parameters to a module that 
calculates the area of a rectangle. 
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Area = 10 * 10 Area = 10 * 10.6 
Area = 10.6 * 10 Area = 10.6 * 10.6 



Table 1: Area calculations using different types of numbers (integer and decimal) 

With overloading, it's possible for us to create one module called area and duplicate it four times to accommodate 
all of the different data types that may be possible to the within the modules parameter list. Look at the following 
pseudo code. This pseudo code example has extended the number data type from just num to integer and 
decimal. 

integer length_int 
integer width_dec 
decimal length_dec 
decimal width_dec 
area(length_int, width_int) 
integer myArea 

myArea = length_int * width_int 
return myArea 
area(length_int, width_dec) 

decimal myArea 

myArea = length_int * width_dec 
return myArea 
area(length_dec, width_int) 

decimal myArea 

myArea = length_dec * width_int 
return myArea 

area(length_dec, width_dec) 
decimal myArea 

myArea = length_dec * width_dec 
return myArea 

- area method with two integers are input parameters. 



- area method with one integer and one decimal as input parameters. 

- area method with one decimal and one integer as input parameters. Note how the order is now different. Before 
we had integer, decimal and now we have decimal, integer. 

- area method with two decimals are input parameters. 

Depending on the values that are sent to this program by the user, one of the overloaded area methods will be 
called. Which one is called depends on the users input. The method is decided at run-time based on the inputs. If it 
wasn't for overloading, how might your program have built differently to accommodate the same flexibility? More 
than likely a series of decisions structures (if statements) would have to be constructed to determine what the 
data type was of the values input and then one of four differently named methods called based on the testing of 
that input. 



OVERRIDING METHODS 



Object Orientated Programming Continued and Expanded | http://laptoppress.garymarrer.com 



Yet another implementation of polymorphism is overriding. Like overloading, overriding gives you flexibility as to 
which method executes at runtime. For overriding to take place, a class must first inherit a parent class. The next 
step requires that the child class override one or more of the parent's methods. Overriding is done by creating a 
duplicate method header in the child class but with a different implementation. Implementation would be those 
statements inside the body of the module. For example, I have decided to create two child classes of student 
named AlCollegeStudent and BlUniversityStudent. Both of these classes will inherit all the members of Student 
and include some new members that are unique to each of these new classes. Since each school has a dean's list 
but each school's dean's list is determined by different GPA, the AlCollegeStudent will to override the deansList 
method of Student to reflect the fact that this school has a requirement for the dean's list GPA to be 3.5 and 
above. Since BlUniversityStudent has the same dean's list logic as Student, it does not have to be overridden. 

See below for pseudo code that 

demonstrates overriding. 



Parent Class with DeansList method 



class Student extends Person 
num gpa 
char major 
num totalCredits 
char studentID 
DeansListO 

status = "false" 
if gpa > 3.25 then 

status = true 

else 

status = false 

return status 
Child Class with DeansList method overridden 



class AlCollegeStudent extends Student 

char campusLocation 
num financialAid 

DeansListO 

status = "false" 
if gpa > 3.5 then 

status = true 

else 

status = false 

return status 

- Here we have new class members specific to AlCollegeStudent 

- Here we have overridden methods that will use different logic that what was inherited from Student. 
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Since UniversityStudent does not have different logic concerning the designation of dean's list, it does not need to 
implement an overridden version of deansList. 



The Student cIbk DesnsList methods is 
Overridden by Its child das& 
AlCoJIegeStudent 




□asfi: Faojtty 



Class: Student 
MethodDeafisList 



Class: A1 CollegsStudent 



Class: B 1 U n iversitySt jdent 
Method-DwnsList 



Figure 2: The object hierarchy showing the DeansList method overridden by its child class. 
Status Check 

Why is overriding related to inheritance? 

Give the conditions in the parameter list that allows for more than one method with the same name? 



Background Information: Object Hierarchy - Object hierarchy describes the family tree of the class object. For 
example, if we look at the AlCollegeStgudent class we will see that its object hierarchy includes a parent called 
Student. Student also has a parent called Person. Because of this family relationship, AlCollegeStudent gets 
everything up the family tree including the members of Person. Most programming languages provide 
documentation that outlines what classes have been inherited by a class. This can provide valuable information in 
determining what class members are available to your program. 
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Object Hierarchy - The object hierarchy acts like a family tree for a class by showing all of the classes It inherits 
members from. Class object documentation should include an object hierarchy for programmers using your 
classes. 



ENCAPSULATION EXPANDED 

You will remember from chapter eight we defined Encapsulation as "information hiding." To fully implement 
Encapsulation we would have to a tie the scope identifiers private and public to our methods and instance 
variables. We would use public methods to set and get data stored in the instance variables. We want to protect 
the instance variables from outside calls and applications. This protection would include not allowing invalid data 
from being stored in the object (i.e. cost values must have a value greater than zero). We also want to hide details 
of the class since details are not important to the class user. The class user only needs to know how to 
communicate with the class via its methods. 

Encapsulation is implemented via the public mutator and accessor methods which protect are class data. By 
convention, set methods are mutator methods and allow us to update instance variable values. Get methods are 
accesssor methods in allows us to retrieve information stored inside the instance variable. All communication and 
updating with instance variables is accomplished through get and set methods.. 

Private scope - Private variables and methods are visible to class members only. Private members cannot be 
accessed by other classes (including driver classes). 





Public scope - Public variables and methods are visible to class members and all other classes with access to the 


class. 





Programming Tip: Encapsulation is important in supporting code reuse but in fact is optional in most programming 
languages. In Java for example, one could create a class for reuse across to many Java applications and not build 
within the code a structure that supporting cancellation. Although possible, this is not advisable because without 
encapsulation more information needs to be provided to the programmer which makes reuse less feasible. 



ACCESSOR (SET) AND MUTATOR (SET) METHODS EXPLAINED 

Most languages use accesssor and mutator methods along with private and public scope of identifiers to ensure 
data hiding in class objects. This is implemented by creating methods of public scope the provide access to data 
(also known as instance variables) that have private access. The public methods are divided into two categories. 
One is the mutator or "set" method and the other is an accessor or "get" method. The "set" method is used to 
change the values in the private instance variables and the get method is used to retrieve the data stored in the 
instance variables. For both of these public methods, you should by convention prefix the method with "get" for 
accessor methods and "set" for the mutator methods. The prefix is placed in front of the name of the data instance 
variable (i.e. the private customerName instance variable would have a public accessor method called 
setCustomerName and a public mutator method called getCustomerName). 

Accessor methods - Accessor methods are modules with public scope that allow for the retrieval of private 
instance variables. Accessor methods are important in supporting encapsulation 
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Mutator methods - are modules with public scope that allow for the update of private instance variables. Mutator 
methods are important in supporting encapsulation 



Encapsulation - "information hiding" 



Private Instance Variable 



private num deposits 



Public Accessor and Mutator Methods 



Figure 3: Encapsulation with get and set methods shown graphically 
PSEUDO CODE EXAMPLE OF ENCAPSULATION 



Below is an example of private instance variable (deposits) with public accessor (getDeposits) and mutator 
(setDeposits) methods 



private num deposits = 0 
public setDeposits(inVal) 
if inVal > 0 then 

deposits = inVal 

else 

print "Invalid Input - Must be greaterthan 0" 
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return 

public getDepositsO 

return self.deposits 

- The mutator set method protects the deposits instance variable from invalid data by displaying an error message 
when invalid data in sent to the class member. 

- The accessor get method retrieves and returns back to the class the data stored In the deposit instance variable. 



Related Subject: OOP and program patterns - Many times this eBook we've talked about programming patterns. 
These patterns are blocks of program logic which because of their generic utility can be used over and over and in 
a variety of applications. The logic necessary to read through the records of sequential files example of a 
programming pattern used in the previous chapter. The same patterns can also exist in class objects. Just like the 
structured programming modules, object oriented methods can also contain statements which would quality as 
patterns that could be reused over and over again. In fact, due to the enhanced reusability of OOP, class objects 
are a perfect way to implement code patterns. Many OOP languages (i.e. if the Java and Microsoft .NET) provide 
API (application program interface) documentation that documents reusable classes that contain many of the 
programming logic the patterns identified in this eBook. 



Status Check 

Are accessor and mutator prefixes of get and set required? If not, what are they? 
Why is identifier and method scope important in support encapsulation? 

USING EXISTING CLASS OBJECTS 

Programmers use class objects from a variety of sources. Typically, most programming languages contain extensive 
class libraries to cover most of the common routines (patterns) necessary to build application programs. Building 
graphical user interfaces that incorporate controls like command buttons and text boxes to classes that facilitate 
opening and closing text files. All of this accomplished with class objects. For most OOP languages, classes are 
divided into namespaces (also referred to as packages). A namespace or package acts like a folder that holds 
classes that provide a similar function. For example, many languages support an 10 (stands for input output) 
namespace that contains classes to facilitate file processing. Just a programmer can create their own classes; they 
can also create their own namespaces. It is recommended that custom namespaces include a URL associates with 
the author as part of the namespace name to avoid name duplication. 



Namespace / Package - Namespace and package files act as containers to hold classes that perform similar 
functions. They make classes easier to locate and use along with help to uniquely divide classes since the package 
name becomes part of the reference to the class. 



You can identify a namespace as a prefix parameter in the class name or you can use the import keyword to 
associate the namespace with the class and make programming statements easier to write. Below I have two 
blocks of code that access a custom class. One state is called without the imports keyword and the other does not. 

garymarrer.myclasses.minMaxClass.min(numOne, numTwo) or with an import statement 

imports garymarrer.myclasses * 
minMaxClass.min(numOne, numTwo) 
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- This example comes from Java although other languages use similar syntax. Notice how the reference to the class 
name is shorter in this code block because the package has been identified in the imports statement 



CUSTOM CLASSES 

For those of you will be taking Visual ~Basic.Net or Java for your first programming class, you'll find that there are 
two types of custom classes you'll need to work with. The first is the driver class which Is used to control your 
program. The second customer classes are the classes that will contain the data and methods to describe "things" 
you are interested in sharing across programs. With both driver classes and the custom classes you are creating, 
you will include within them calls to other classes. Some classes which will come from class libraries (with 
numerous namespaces) included with the language and others you may have created. The programs in OOP 
become a mix of various class objects and control logic. 

DRIVER CLASSES - YOUR FIRST CUSTOM CLASS 

The first custom class is a driver class and typically the first class you will create as an object oriented programmer. 
The driver class contains the instructions that determine the order in sequence of the program logic. The driver 
class looks and acts very much like the programs we developed in structured programming. The driver class still 
contains instance class variables along with methods but acts as a self contained unit where all the program logic 
could exist within that one class. The driver class holds a special status and that it can be executed as a program. 
The drive class is the first class the executing environment looks for to start the program. I would contrast this with 
other custom classes which contain only data and information about anything used within the program. These 
classes need a driver classes to instantiate them into call the members during program execution. For example, the 
Student class we worked on earlier in the section on inheritance cannot be executed unless it is instantiated and 
called in a driver class (note: there are some exceptions to this but any valid program must be started by the driver 
class). 

Key Concept: In most object orientated programming languages, the main logic of the program is also kept inside a 
class file even though this class may not be instantiated. In Java for example, the driver class has a class statement 
that corresponds to the program name. When the program name is executed the driver class is found and the logic 
of the driver class is started. This makes the driver class very similar to our program files created using structured 
programming techniques. 



Driver Class - The driver class contains the mainline logic which drives the instantiation of other class objects and 
uses class objects with programming structures (i.e. control structures) to define the logic of the program and the 
sequence of the called instructions. The execution environment looks for and starts with the driver class. 



Logic TIP: The driver class is probably the closest thing to the logic found in a structured program. It contains the 
mainline logic necessary to drive the steps of the programs. 



CLASS SCOPE 

Just as variables have program scope so do class objects. The scope of classes is much the same as is with 
variables. When the program instantiates a class object, that class object points to a location in memory where the 
class object has been loaded. If the object variable has been instantiated and inside a method then that class is 
local to that method and not available to other methods in the driver class. If the class object is declared in the 
body of the driver class, this makes the class and its members available to any statement and any method of the 
driver class. See below for example of a class that's declared as global to the driver class (globalStudent) and a 
class that is declared local (localStudent) to a method. 
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public class myTest 



private Student globalStudent 

public myMethod 

private Student localStudent 

print globalStudent.toStringO 

return 
end class 

- globalStudent represents a custom class that because it has been defined in the body of the class is global to all of 
the class members. As a result, the globalStudent class object is callable from within the myMethod method. 

- myMethod contains is own local class and also calls a global class 

- localStudent is only visible to the statements in myMethod. 

- globalStudent is visible because the object variable was defined in the body of the driver class 
COMPILED CLASSES 

For instruction purposes, we have always shown the class files source code called by the driver class. This is a 
luxury that you typically will not have as a programmer. For most of the classes that either are called from the 
programming language libraries or custom classes written by other programmers, you'll we'll have access to the 
compiled code only. When a program or class is compiled the source code statements, which are typically in 
English and formatted with the programs keywords, will be converted to either machine code are byte code which 
consists of binary characters. Binary data cannot be opened with a text editor to inspect programming statements. 
What this means is that you will have to understand what each class contains in how to call its members. This 
information is available in a couple of places. First of all, many languages provide a software application via the IDE 
called the class browser. The class browser acts like file manager works with files except the class browser allows 
you to look at class members. With a class browser, you can see what a class member will return in what inputs are 
required as parameters. 

Still another source of information about the documentation of classes and its members is through the API 
(Application Program Interface) documentation. This information will be displayed in a more traditional format 
where the class and its members will be cross reference to a table of contents which will allow you to navigate to 
the information you're interested in finding out about. From that information, you will be able to find out the 
name of the class and how to use each of its members. 

Class Browser - A class browser is a software tool included with the programming languages IDE to display the 
classes used by the program and the members of those classes. The class browser will let you browse through your 
class objects like a file browser lets you browse through your hard disk... 



API (Application Programming Interface) - The API is the documentation included with your classes to identify the 
classes in the package and the members in each class. The API is similar to the class browser but is in the form of 
documentation whereas the class browser is a software application. 



Object Orientated Programming Continued and Expanded | http://laptoppress.garymarrer.com 



CopyrlgfilcO malanal 



You may be asking what the benefit of a compiled class is if it requires the programmer to access these other 
information sources to know how to use the class object; for starters many classes are very complex and written 
by experienced programmers. The even if the source code was available, the average programmer may not be able 
to glean any effective information from looking at the source code. After all, is this not the reason for information 
hiding and code reuse? As we have discussed in previous topics, the programmer need only know what messages 
to send the classes input and understand what messages will be returned as output to effectively use a class and 
its members. 

Still another reason for compiling class objects has to do with security and protecting intellectual property. It may 
be entirely possible that certain classes execute code which if available to less scrupulous programmers, might 
allow for the hacking or misuse of the class, a compiled binaries class object minimizes this exposure. A second and 
probably more plausible benefit for compiling class objects has to do with the protection of intellectual property. 
As a programmer, your source code statements are just as valuable to you as the lines of text to an offer writing a 
novel. The programming instructions represent the fruits of your labor and the design that you alone have created. 
For this reason, this design in the implementation of it is yours to own and should not be available to others to use 
or exploit without your permission. Although not foolproof, compiling a class object will help minimize any theft of 
your intellectual endeavors regarding the custom class you created. 

Compiling class objects can also help with program maintenance and reuse. If the source code is delivered with 
the class any programmer could modify the source code and create a new version of the class. One of the 
requirements of code reuse is that reusable code is the same everywhere it is used. If original class was changed, it 
would be unlikely that the change made by the original author would work correctly on any classes that were 
modified without their knowledge. Think about this scenario. What if I was to send a class object out to my 
programmers that contained the calculation of product cost? One of the programmers using the class changed the 
class object directly instead of inheriting it. I then send an update to reflect a new product cost. There is a strong 
possibility that the changed class code would break unless they again changed my original class code. This is 
unproductive and sloppy most likely leading to program quality issues. Compiled classes prevent unsanctioned 
updates of the class by hiding the source code and requiring programmers using the class to interface with it or 
inherit it into a new class. 

METHOD HEADERS 

As the previous two topics elaborated on, most of the time as a programmer choosing to use classes to implement 
a solution, you will not see the source code. You will work with the class via messages. Because of this, the class 
browser in any documentation available for the class will only give to you information necessary to send inputs and 
received an output from that member. This is especially true with class methods where each method has a name, a 
parameter list and an indication if any data is returned by the method. 

For example if we look at the set and get methods used earlier in regards to demonstrating encapsulation and on 
the deposit instance variable, we will see that the setDeposits method has a header which requires one character 
value as input without returning any valued back to the calling statement. The method header for getDeposits 
method accepts no parameter information as input but does return a single value. What happens inside these 
methods is of little consequence to the programmer. The programmer trusts that the person who created this 
class member has code the logic of the member correctly. 

setDeposits(num inVal) 

deposits = inVal 
return 

getDeposits(): 
return self.deposits 
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Class Method Headers 
Java deansLisf Method 



public boolean deansLlstj(double gpa) 
i 

If (gpa > 3.5) 
{ 

return true; 

} 

else 
{ 

return false; 

} 

Header Inforrnation: 
Name: deansLlst 

Input parameters: one, data type double 
Returned variables: one of data type boolean 



Visual 6asic.Net DeansList Method 



public Deans List( gpa as dacimai) as boolean 
{ 

if (gpa > 3.5) 
{ 

return true; 

} 

else 
{ 

return false: 

} 

Header Infofmatlon: 
Name: deansList 

Input parameters: one, data type double 
Returned variables: one of data type boolean 



Figure 4: Java and Visual Basic. Net IVIethod Header 
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ABSTRACT CLASSES AND ABSTRACT METHODS 



To describe the concept of abstract classes we need to return to an example used earlier when we discussed 
inheritance. We had a scenario particular to the parent class of Student. It turned out that the Student class was 
inherited by two subclasses, specifically, AlCollegeStudent and BlUniversityStudent. Even though many of the 
members could be inherited and utilized easily by the subclasses, it was at least one method called DeansList 
which had to be overwritten by the AlCollegeStudent class because its rules regarding the DeansList were 
different than its parent. In the case of, BlUniversityStudent, the DeansList method did not need to be overwritten 
because it shared the same criteria as its parent student. 

Abstract classes give us more flexibility in regards to situations like what was seen with the DeansList method. 
Perhaps a more efficient and more reusable solution would have been to create an abstract method called 
DeansList. An abstract method is a method that contains only method header information. With abstract 
members, it is expected that the child class will implement that method. Implement in object oriented 
programming means create the body of the method. In other words, the parent's abstract method contains only 
the header line of the method in the child's class contains that same header line plus all the statements that would 
go with that method. If this was done on the DeansList method in the previous example, both AlCollegeStudent 
and BlUniversityStudent have their implementation of DeansList. The pseudo code below illustrates how this 
would look. 



Abstract Class - Is a class that cannot be instantiated because one or more of its members are abstract and contain 
no class body. Abstract classes can only be inherited. 



Programming Tip- If you have an abstract method but have not defined the class as abstract then most compilers 
will return a compiler error message. 



Parent Class 

The parent class contains an abstract method which will require that the class be designated as abstract. 

class abstract Student extends Person 
num gpa 
char major 
num totalCredits 
char studentID 

abstract DeansList() 



- Since the class contains an abstract method, the entire class needs to be identified as abstract. 

- The abstract class DeansList only contains header information. 



Child Classes 
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Both child classes have been represented in the pseudo code below. Note how both classes inherit Student and 
both have their own implementations of DeansList with the same header as their parent (Student) but with 
different logic in the body of the method. 

Child Class 1 

class A2CollegeStudent extends Student 
char campusLocation 
num financialAid 

DeansLlstO 

status = "false" 
if gpa > 3.5 then 

status = true 

else 

status = false 

return status 

- Here we have the abstract DeansList method implemented in its subclass. 



Child Class 2 

class BlUniversityStudent extends Student 
char campusLocation 
num financialAid 

DeansListO 

status = "false" 
if gpa > 3.5 then 

status = true 

else 

status = false 

return status 

- Here we have DeanList method implemented with logic that requires a student have a GPA greater than 3.5. 
CONCRETE CLASSES 

Until we introduced abstract classes we were working exclusively with concrete classes. Concrete classes contain 
no abstract methods and can be instantiated as and used as class objects in our programs. As mentioned earlier, 
abstract classes can only be inherited and not be instantiated as a class object. Common sense dictates the reason. 
These classes are incomplete due to the fact that one or more of their methods are not fully implemented. 



Concrete classes: Concrete classes are the default class and have no abstract class methods. They can be inherited 
or instantiated. 



TESTING OOP PROJECTS 

Testing programs developed using object oriented programming languages is fundamentally no different than 
what was discussed earlier we were developing our programs using structured programming techniques. With any 
good test is a plan, as the programmer, you have to ensure that all the logic within your program is tested 
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appropriately. The test plan should systematically identify all modules and control structures and test all inputs 
that would cause the program to fail or not return a useful error message. 

Status Check 

Why are abstract class only inherited? 

Why it that the method header is all a programmer is needs to use a class method? is this an example of 
abstraction or polymorphism? 

OOP AND THE PROGRAMMING PROCESS 

In chapter one, we discussed how programmers use a process to develop programs. We used this process when 
we created programs using structured programming techniques and now we will review this process again in light 
of what we have learned with object oriented programming. You will see that the process stays the same and can 
be used just as effectively with OOP as with structured programming. From a prior chapter the definition of a 
program development process: 

Program Development Process (PDP) - you can think of the program development process as standardized set of 
steps used to provide a logical, common sense approach (or process) to solving a difficult problem with a computer 
program. PDP is for the programmer a lot like a checklist that ensures that the steps of building a program are 
followed so that no important step is omitted or taken out of order. This process has long been used by 
programmers as a professional standard because of its simplicity and consistency. 

This program process is still relevant to the programmer using object oriented techniques even if some of the 
modeling tools are different. 

• Start with a problem statement: No change here. This step stays the same and is critical in defining the 
scope of the problem and what exactly your program will need to do. 

• Fact finding or requirements analysis (done by interviewing program end user): Fact finding is still critical 
to capture the background data necessary for identification of classes, class members and logic for the 
driver class. 

• Conceptual design: Conceptual design usually takes the form of pseudo code or a flowchart that lays out 
the ideal logic structures to provide a solution. Our conceptual design has focused on pseudo code in the 
past two chapters. Suspiciously absent were flowcharts which will be replaced with UML (Unified 
Modeling Language) in the next chapter. UML is the standard for graphically modeling logic that will be 
implemented using object oriented programming design. 

• Detail design: We are ready to code our solution using a programming language. We take the conceptual 
design as a starting point and using the syntax options of the programming language, code the logic 
structures into programming language structures. This process step also does not change significantly 
except we are now designing driver and custom classes in addition to just program logic statements. 

• Testing: We will perform unit tests as we go. We always need to test and the testing of class objects is just 
as important as the testing of structured programming applications. 

• Implementation: During implementation, we move into production the test average calculator program 
on to the PC of the person using it. The program is complete and ready to use. 

• Maintenance: No program is written once and not revisited without some changes. With object 
orientated programming and its extensive use of reusable code, maintenance is make more efficient since 
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a class code is shared and a change to that class can be made once and propagated across to all the 
programs that use the class object. 





The 
Programming 
Process now 
with OOP 




Implamenrtation 
Test Plan Executed 



Figure 5: The programming process using object orientated design techniques 



CACTUS CASE STUDY 



The light bulb is starting to get a little brighter with his chapter's coverage of object oriented programming. You 
are beginning to see how OOP can make a significant difference in programmer productivity and how classes can 
save a lot of time and maintenance down the road. Based on Cactus Books and Tapes web site requirements, the 
web payment service can be implemented in several programs. But more importantly, now that you understand 
more about inheritance, the WebService payment method can be inherited and expanded upon to fill in added 
function needed by the web site but not included in the web service. 
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You have told the Chavez sisters that reusing the code from the credit card company and adding an overriding the 
class with additional members can accommodate many of the e-commerce functions needed to keep the web site 
secure and easy to use for the customer. 

Look at the following requirements and implement then into a new class called CBTPayment. You will need to 
create a driver class to test your new class members. To do this your program must input parameters to each of 
the new methods for testing. We only work on testing the class in this exercise. We need to show the Chavez 
sisters how this is going to work. 



CASE STUDY TASKS: 

• Inherit Web Payment into a new class called CBTPayment (CBT for Cactus Books and Tapes) 

• Override Payment to capture store number and payment date 

• Add Instance Variables for store number and payment date 

• Add set and get methods for new instance variables 

• Create Driver Class to test the new class 

WEB SERVICE CLASS OBJECT WITH PAYMENT METHOD 



This is the class called from the credit company. 



class WebPayment 

payment(customerName, customerCCNumber, expDate, Amount) 
open CustomerFile 
while not End-Of-File 

read custID, custCC, custExpdate 
if customerName = custID and 
custCC = customerCCNumber and 
custExpDate = expDate then 
status = "approved" 

else 

status = "rejected" 

return status 
end class 

Web Service Class Object with payment method 



Below is our new class with new instance variables, inheritance, encapsulation and polymorphism implemented. 

class CBTPayment inherits WebPayment 

char storeNumber 
char transDate 
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payment(customerName, customerCCNumber, expDate, Amount) 
open CustomerFile 
while not End-Of-File 

read custID, custCC, custExpdate 
if customerName = custID and 
custCC = customerCCNumber and 
custExpDate = expDate tlien 
status = "approved 

setTransDate(transDate) 
setStoreNumber(5) 

else 

status = "rejected" 

return status 

setStoreNumber(inStoreN umber) 

if inStoreNumber <> 5 then 

storeNumber= InStoreNumber 

else 

print "Invalid Internet Store Number" 

return 

getStoreNumberO 
return storeNumber 

setTransDate(inTransDate) 

if inTransDate <> "" then 

transDate = InTransDate 

else 

print "Date cannot be blank" 

return 

getTransDateO 
return transDate 
end class 

- The CBTPayment class inherits the WebPayment class with the inherits keyword 



- By convention, instance variables are defined at the top of the class statements. You will see each instance 
variable has its own set of mutator (set) and accessor (get) methods. 

- The payment method has been overridden by defining a method with the same name 

- We have changed the payment method by collecting the transaction date and store number with this internet 
transaction. The store number will be hard coded to number 5 indicating this transaction was done via the 
Internet. 

- The mutator setStoreNumber method will only allow a 5 to be stored as a store number. 

- The mutator setTransDate methods will not allow a blank or empty transaction date. 
Pseudo code Driver Class Solution 

Note: For this program, I have left off the robust data validation you would normally find in your program. We are 
focusing using a class and calling its members in this example. 
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class MyClassTest 

declare Variables 

CBTPayment myPayment 
custName = input("Enter Customer Name ") 
custCreditCard = input{"Enter Customer Card Number") 
custExpDate = input("Enter Card Expiration Date ") 

custAmount = input("Enter Purchase Amount ") 
storeNumber = input ("Enter Store Number") 

transDate = todaysDate() 

print "Purchase Status" 

print myPayment.payment(custName, custCardNumber, custExpDate , custAmount) 
print "Thank you for your Business!? 

end 

- Here we have two number instance variables called from our new class 

- Most programming languages have a date function to extract from the computer today's date. todaysDate() is a 
placeholder indicating the programmer should use the built in function for today's date. Our example will use the 
built in todayO function from PYTHON. 



PUTTING IT TO USE 



The intent of this section is to introduce the new programmer to standards and techniques frequently used by 
professional programmers. Topics in this section relate to concepts introduced in the chapter but with a more 
vocational or occupational focus for students considering a career in programming. 

Best Practices: OOP Conventions and Standards - OOP is no different than structured programming in that there 
are standards which have been developed which need to be incorporated into the design and coding of OOP based 
applications and Classes. Creating applications which use industry standards will provide a convincing case to your 
professionalism in the development of software. It will also make maintaining your program much easier. You 
should learn in implement these standards in all of your OOP programs. The sooner you train yourself to use these 
standards, the better off you'll be as you create more complex programs. 



A LIST OF STANDARDS COMMONLY USED IN OOP: 



• To support encapsulation your mutator methods should start with the prefix set (lower case) and your 
accessor methods should begin with the prefix get (also lower case). The access methods should have 
public scope and the instance variables should have private scope We will cover get and set methods 
formally in the next chapter. 

• Instance variables and methods should always start with a lower case letter. If the method or instance 
variable contains two or more words in every word after the first letter should start with an upper case 
letter, this is called camel casing. Instance variable are defined at the top of the class file before methods. 
For example, the variable total cost would be represented as totalCost. See how the C in cost has been 
capitalized. 
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• Class Definitions should always start with an upper case letter. By convention, class files always have the 
first letter capitalized. Other letters are a combination of lower and upper case but typically follow camel 
casing conventions. 



ADDITIONAL INFORMATION: CODE MAINTENANCE WITH OOP DESIGNED PROGRAMS 

I have already in this chapter and the previous chapter alluded to the fact that class objects can make code 
maintenance simpler with fewer chances for introducing new errors. It is best to present this as a scenario. For 
example if we go back to the Person and Student classes covered in the section on inheritance, what if I decided 
that each person also has a telephone number? If telephone number is truly something which belongs to a person, 
I can add telephone number to the Person class and it will automatically give it to all of my children. This is in 
contrast to deciding that each of the children needs a telephone number. If they did not inherit from their parent 
each child class would have to have code added to it to accommodate telephone number data. Not having 
telephone number inherited could be more time consuming and complicated because of the number of classes 
that would have to be updated. With many telephone number updates to make, the possibility of missing one is 
very high. Missing one on a child class is zero. 

I have an example for you to think about. Does everyone remember the infamous Y2K melt-down scare where all 
computers would be coming to a screeching halt when the clock struck twelve and the date moved over to 
1/1/2000?. Each program had to be checked for any invalid year 2000 date processing code. If the date code was 
inherited, would the verification and repair been as labor intensive (and therefore very time consuming and 
expensive)? The answer is no. Use of class objects and inheritance would have certainly made class updates much 
more effective. 



Background Information: One Error for Every Two Errors Fixed - It is not unusual for a fixed logic error to introduce 
new errors. I once worked on a project where for every two errors fixed a new error was introduced. Not a record 
to brag about and one that required an increased emphasis on program quality (a lot of late nights and status 
reports to management). This system did not use an object oriented programming environment and with code 
reuse I am confident that we would have seen much better quality. A library of reusable code would have brought 
a homogeneity and consistency that would have helped better manage error resolution. 



CHAPTER REVIEW 



Chapter summary, highlights, key terms, short answer questions, quizzes and case studies to reinforce topics 
covered in this chapter. 

CHAPTER SUMMARY 



After finishing this chapter you should understand and in some cases, demonstrate the following topics: 

• Explain and develop custom class objects. 

o Although as a programmer you will probably make more use of predefined class objects, there 
will be many occasions where you will want to create class files to share across multiple 
programs because of the code reusability. 

o Many languages use create custom driver classes, which closely resemble the programs written 
with structured programming techniques, to hold the program's logic. 
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• Recognize and define concepts of encapsulation as it pertains to information hiding, code reuse and 
accessor and mutator methods. 

o Encapsulation is implemented by creating public scope accessor and mutator methods to update 
and retrieve private scope instance variable data. 

o By industry standard, mutator methods are identified with the "set" prefix and the accessor 
methods are identified with the "get" prefix. 

• Recognize and define concepts of polymorphism by overriding and overloading class methods. 

o Polymorphism provides dynamic binding for concrete and child classes by allowing methods to 
be overloaded or overridden. 

o When a method is overridden, the child class creates methods with the same method header as 
its parent but with different logic in the method body. 

o Overloaded methods allow for multiple methods to have the same name but different parameter 
lists. The program decides at runtime based on the parameters which version of the method to 
execute. 

• Recognize and define concepts of inheritance along with concrete and abstract classes. 

o Inheritance allows the programmer to implement code reuse along with simplifying maintenance 
by sharing class members across class files. 

o Inheritance consists of a parent class and child class. Parent classes are also known as 
superclasses and base classes and child classes are also known as subclasses and derived classes. 

o Abstract classes contain one or more abstract methods that have a method header defined but 
no method body. Abstract classes can only be inherited where their children must implement the 
abstract members they inherited. 

o Classes that are not abstract are concrete and can be instantiated. Classes are concrete by 
default. 

• Describe the programming process as it relates to object oriented programming. 

o The programming process with OOP stays the same as defined with structured programming and 
can be used just as effectively with OOP as with structured programming. 

o The conceptual design phase in object orientated programming moves away from flowchart and towards UML 
(Unified Modeling Language) which was developed specifically for object oriented design. 

CHAPTER KEY TERMS 



Abstract Classes 

Accesssor Methods 

API (Application Program Interface) 

Child Class 

Class Browser 
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Concrete Classes 
Driver Class 
Mutator Methods 
Namespace / Packages 
Object Hierarchy 
Parent Class 
Private Scope 
Public Scope 
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PART 3 INTRODUCTION TO OBJECT ORIENTATED PROGRAMMING 



CHAPTER 10 OBJECT ORIENTATED PROGRAMMING DESIGN 



IN THIS CHAPTER, YOU WILL LEARN HOW TO: 



• Describe and explain tlie important elements of implementing effective class object reuse across different 
computer platforms. 

• Explain and demonstrate the logic modeling using Object Oriented programming techniques. 

• Demonstrate the design of logic and programming using Object Oriented Programming techniques. 

• Define UML and recognize logic modeling diagrams and their roles in modeling class object data and 
processes. 

• Define and recognize runtime exception errors and the handling of those errors. 



DESIGNING CLASS OBJECTS 



This chapter wraps up our coverage of object oriented programming (OOP). We started our discussion of OOP with 
coverage of terms and topics. In that first chapter, we used classes in our programs that were already developed 
for us. In chapter nine, we begin to create a room classes and understand the importance of encapsulation, 
inheritance and polymorphism in implementing code reuse. In this chapter, we developed class objects in both 
pseudo code and PYTHON and called them from driver classes. We found the driver classes or very similar to the 
programs created earlier using structured programming techniques. It is my hope that in this point of our 
instruction on OOP that the "light bulb" has become brighter and that you are becoming more comfortable 
understanding basic object oriented concepts and techniques. 

At this point in our discussion of OOP, we have then are modeling using pseudo code. Although pseudo code is 
always effective in creating logic steps that simulates program code, pseudo code has always been more effective 
for the programmer than for the user. The way that pseudo code has been used so far with objects has been to 
assume that all of the requirements have been identified completely and correctly with the help of the end user. 
To design an application from scratch, and going back to earlier chapters, you'll remember that the requirements 
phase of SDLC is critical for the success of the application. On one hand it includes the end user who is always the 
best source of information on how the problem is defined but by also including the end user you can promote buy 
in which can be an important factor in the programs acceptance. 
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The best way to include the end user is in the collection of the requirements and the design of the solution is to 
have some process of graphically demonstrating what is currently being done and what the new program will do. 
With structured programming, this was accomplished with the help of a flowchart. 



Related Subject: Systems Analysts - Management of the development process is typically done in large companies 
by a systems analyst. Systems analysts act as project managers to ensure that the phase of SDLC are managed and 
completed to meet both resource and budgetary constraints. Even though systems analysts are very prevalent in 
larger businesses most small businesses don't have the luxury of such a position. At small businesses, the 
programmer assumes the responsibility of systems analyst. This is the reason that throughout the eBook we have 
spent many a page on understanding SDLC and applying programming processes/procedures and the formulation 
of program logic. The system analyst uses the same tools but also uses tools as programmers to expand the logic 
model at the program and project level. In a programming environment which used structured programming 
techniques, the systems analyst uses data flow diagrams to document processes and entity relationship diagrams 
to identify data elements. In the object oriented programming world, the systems analyst uses UML. Unified 
Modeling Language captures much of the same kind of logic detail returned by data flow diagrams and entity 
relationship diagrams. We cover the parts of UML most important for the programmer writing OOP programs. 



Logic Tip: Data flow diagrams act like detailed forwards that show the flow of information through a process. An 
entity relationship diagram shows how the data is organized logically before it is placed in a database or text file. 
The data flow diagram helps the analysis plan for logic and the entity relationship diagram helps the programmer 
plan for database/file design. 



It is important to return again to the question, why create logic models? Many chapters have passed since we last 
discussed the subject. Earlier in the eBook, I talked of the discipline and rigor that goes into becoming a 
professional programmer. I talked about a scenario where we were going to build a house. We could either bill 
that house from scratch or from a blueprint. If we built it from scratch we would be using unreliable and in precise 
approaches like how we think it should be built or maybe from a picture of a house. What we would end up with 
might be something that looked like a house but would follow none of the standards used by professional builders, 
plumbers and electricians. We would have a house that probably was not structurally secure and a house that 
would be difficult to repair since none of our building would have met the standards used by other builders. 

The logic model provides a plan. Like a blueprint, our logic model will not be perfect and as we build the program 
we might find it necessary to deviate from the original blueprint. Since a blueprint is still a visualization of what 
something should look like, when we get to the work site and actually build that house, we may find that because 
of the environment surrounding the house that accommodations might have to be made that alter the original 
plans. This same flexibility is present in the logic models we create. The logic model is a visualization of what we 
think should happen. After developing and testing, we may find that our original logic was an error or that it might 
not be possible to implement the exact model because of the particularities of the programming language used. 

DESIGNING FOR REUSE ACROSS COMPUTERS 

One point should be understood regarding object oriented programming is that just because a class file was 
designed that does not mean that the class file are reusable. For example, in some of the set methods that we 
developed in chapter nine, I included logic which tests if a numeric value was greater than zero. If it was not, the 
message was sent to the screen letting the user know that they had input invalid data. Is the input validation inside 
the mutator method that requires a error be displayed to a computer screen a good example of reusable code? 
The answer is no. What if I was using this class in an application which runs on a cell phone? Is the display on the 
cell phone the same size as the display on my PC? No, it is not and therefore what I should've done has left the 
actual presentation of the message inside the driver class and not in the class file. The class file should have 
registered the message and passed it to the driver class for display. A driver class could have been created for the 
cell phone and for the PC and they each could have handled the display of the message in a form appropriate for 
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the platform the program was being executed from. We will demonstrate this later in the chapter when we talk 
about exception handling an object or did programming languages. 



Personal 
Computer 
Application 




PDA Application 




Call guessANumter 

If Exception Ituown 
Display message to PDA 



||||||er 



HangManGameClass 



[ler is a special Character and riot e tetter or number 
iw an emt exception 




Figure 1: Building cross platform error messages 



As this last example illustrates, the programmer who is writing reusable code needs to make sure that they 
understand the variety of computers which may be utilizing this class object. If you think about the class examples 
used in this eBook many of them would work just as well on a PDA, cell phone or some other device with an 
embedded computer and if we really are trying to avoid rewriting code over and over, why would we not want 
these classes to work on other devices. Make sure that you have taken consideration how input is received into 
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your program and how put is displayed. These will be the two areas which will most likely cause problems on other 
devices. 



Related Subject - User Interface Design - We've already discussed driver classes in the previous chapter. As we 
move past this chapter into event driven processing, you will more about graphical user interface design. One of 
the features unique to each computer platform is the alternatives it has for displaying information. A personal 
computer with a display monitor has far more output options in regards to color and size then a cell phone. As a 
result, if your class files are truly generic and not written to output to only one display, you should be able to use 
your driver classes to control the display in use a technique called exception handling (covered later in the chapter) 
to keep your shared class objects free of display statements. The class file will send the user interface driver class 
messages containing errors or problems and let that driver class user interface determine the best way to format 
the information to the user. 



One other reminder in regards to code reuse is to remember that when developing classes whether they're 
standalone classes or classes that will be inherited by other classes, look for data attributes and methods which 
will be generic. This is not to say that a method needs to work the same in all cases but make sure that methods 
are created in a way that they might be overloaded to accommodate different uses. Getting too specific in 
identifying class members or becoming two detailed with class member logic can limit reuse ability which defeats 
the purpose of developing class objects. 



Programming Tip: Design class objects as generic as possible so as to maximize inheritance and abstraction. 



DESIGNING WITH MODELS 

Our original models constitute what is called the conceptual design. Conceptual models are perfect world models 
which can include solutions which may ultimately be incorrect or impossible to implement. With conceptual 
models, we try to think outside the box and take from our end users their requirements unrestricted and unbiased 
from approaches used in existing systems. 

Let me present a scenario of how the conceptual model might not become our actual program. Our original model 
might plan for processed data to be returned to the user in less than two seconds. We may find that the model we 
created when translated into program code returns data in less than five seconds. It is unlikely and 
counterproductive to remodel the entire program. What is more feasible and practical is that new program code 
would be inserted that would improve program performance even if it was different then a model. This code 
would represent a fix to the problem but would be a change from the original logic model. This is why when we 
create our conceptual design that we are more interested in a perfect solution than a solution which is technically 
and operationally perfect. We know that until the program has been created and tested that there is no way to 
create the perfect model on the first try. This takes practice and experience. Many of you may of have found that 
modeling can be a very unnatural and challenging activity. I will also tell you that with time modeling will become 
much more intuitive. 



Logic Tip: Many times conceptual "best case" model of a system will develop the solution from scratch and not be 
biased towards the existing method of accomplishing a task. This new perspective can have benefits to the 
programs and the business in a variety of ways. 



Next, we will introduce UML or unified modeling language. We have been talking about it for the last couple of 
chapters and now is the time to introduce this modeling tool as part of object oriented programming. One could 
have argued that UML should' ve been the very first topic covered as part of OOP. Technically it could have but as 
you'll see when we cover it in this chapter, it is significantly different than the flowcharting that we have already 
learned and may have added additional confusion to an already complicated topic (OOP). Now that you've had 
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some experience and exposure to class objects, I believe that UML be more straightforward and will only help to 
reinforce what you have already learned regarding object oriented programming. 



UML - Unified modeling language represents a series of nine graphical models that represent the software artifacts 
found in a system. From UML diagrams, systems are programmed, integrated and deployed. Like any model, UML 
represents a conceptual view of a process. In short, UML creates a picture of how something is done with graphics 
easy enough to communicate to the non-technical end user. 



Status Check 

Why is taking cross platform class design important to code reuse? 
What do we say that conceptual models let us think outside the box? 



INTRODUCTION TO UML 



UML represents the collaborative effort of three individuals. Grady Booch, James Rumbaugh and Ivar Jacobson in 
the nineteen eighties and nineties were all developing methodologies for object oriented design. Even though they 
each or developing their own set of models they also found themselves collaborating with each other. All three 
were united at Rational Software Corporation now a subsidiary of IBM Corporation. The first release of UML 
(version 1.0) was adopted by the Object Management Group (OMG), an independent standards body, and released 
in 1997. OMG version 1.5 is being discussed in this eBook and version 2.0 is currently undergoing comment in 
preparation for adoption. 

There are many web sites with offer free resource and learning materials on UML. A couple of sites I would start 
with are: 

• www.uml.org - Maintained by the Object Management Group (OMG). 

• http://www-306.ibm.com/software/rational/ - Maintained by IBM Corporation 



It is important to understand that UML represents a methodology that includes diagrams to support the entire 
development lifecycle. This far exceeds the scope of diagramming we have seen in the eBook so far (i.e. 
flowcharts). The closest UML diagram to what we know is a flowchart is an activity diagram. However, there are 
also elements of UML sequence diagrams and statechart diagrams which can be represented within our 
flowcharts. Since this is not a eBook on object oriented analysis and design, we will not cover all of the diagrams 
included in UML. 



WHY LEARN UML? 



UML is a tool used by systems analysts to develop object oriented programming applications. If it is a tool for 
systems analysts, why is UML covered in this eBook? As mentioned in a previous paragraph, there are parts of UML 
which worked very well in helping us create class files and class file logic. We have a restated how important 
models are in creating a plan for program logic. We will learn the UML diagrams which are most likely to show up 
in an entry level programming class textbook or as part of the programming specifications for a new or existing 
program. 

UML Goals (from OMG UML 1.5 Specification 
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The OMG Specification document defines UIVIL and is tine prinnary resource for those worl<ing with UML. The 
specification also identifies the benefits of UIVIL and the design goals. 

• Provide users with a ready-to-use, expressive visual modeling language to develop and exchange 
meaningful models. 

• Furnish extensibility and specialization mechanisms to extend the core concepts. 

• Support specifications that are independent of particular programming languages and development 
processes. 

• Provide a formal basis for understanding the modeling language. 

• Encourage the growth of the object tools market. 

• Support higher-level development concepts such as components, collaborations, frameworks and 
patterns. 

• Integrate best practices. 



Logic Tip: As of this writing the OMG UML standard is at 1.5 with 2.0 announced. You can find more information on 
OMG specifications on the OMG web site. 



UML CONCEPTUAL DESIGN 

For this eBook, our conceptual design will include three different UML diagrams. We will learn the UML Use Case, 
Class and Activity diagrams. The Use Case Diagram is a very effective tool in documenting program scope and the 
business processes involved. It is especially valuable for including the end user in the requirements process since it 
is one of the simplest UML diagrams to use and it typically documents program processes at a high level. 

Class diagrams document all class members and their scope. It also documents the relationship between different 
classes. 

Activity diagrams allow us to document the logic in individual processes. It is the closest UML model to the 
flowchart and you will see a number of similarities. In activity diagrams, we diagram something close to close at 
the module level. 



Logic Tip: As it is the case with all logic models, one of their functions is to help the programmer plan out the 
application before the programming statements are added in the other is to give the end user of view of the 
system in the planning stage so their input can be included in the design. 



PROGRAMMING PHYSICAL DESIGN 

We know that conceptual design includes the definition of logic models. What about programming? If it is not 
conceptual design than what is it? Programming is included in the physical design. Included in physical design is 
also the building of the files and databases necessary to complete and test the application. Physical design 
represents reality. Whereas the conceptual design represents a perfect world and the ideal solution, the physical 
design represents the completed work that has implemented the solution based on the constraints of program 
statements and their ability to implement logic. 
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UML DIAGRAMS DESCRIBED 



UML is not a static process but is dynamically and continually changing based on new technology and 
recommendations from programmers and systems analysts. Recently, the UML 2.0 has been introduced with 
changes and enhancements to UML (more information on the different versions and modifications can be found 
on www.omg.org or www.ibm.com/rational). The UML diagrams of version 1.5 define the behavior, structure and 
interaction of the models and the software artifacts then define. The list of diagrams currently included as part of 
UML 1.5 is as follows: 



STRUCTURAL DIAGRAMS: 



• Use case Diagrams - Use Case diagrams use systems actors and their relationships to determine the 
functions and features (also called use cases) of a system. In simple terms, use case diagrams are used to 
identify what things a system needs to do (i.e. accept payments, look up customer information) to meet 
the end users requirements. This is one of the more useful UML diagrams and is very beneficial for 
defining system requirements. We will cover this model in the eBook. 

• Class Diagrams - Class diagrams are structural models that document the systems classes and the 
relationships between those classes. Class diagrams document class members (i.e. instance variables, 
methods and events). With each member a + (public), - (private) and # (protected) symbol is used to 
identify the scope of the member. Class diagrams are important UML diagrams for programmers to 
understand. We will cover this model in the eBook. 



Programming Tip: The UML Class diagram is frequently found in programming textbooks. It is used to document 
class objects and there members. 



BEHAVIOR DIAGRAMS: 

• Statechart Diagrams - A statechart helps to document the states the object supports and events that may 
trigger state transitions. The states represent activities like starting, a pause, turning off, ending, adding, 
updating, deleting, etc.). For example, the class object may have different methods/events that perform 
tasks based on a state the program is in. The object may have one state before the purchase of a product 
and be in a different state with a different method after the sale. We will not cover statechart in this 
eBook. Statechart diagrams are also called state diagrams. 

• Activity Diagrams - Activity diagrams come very close to data flow diagrams and flowcharts in their ability 
to detail program logic. You can use this diagram in the beginning of the requirements process to isolate 
details on use case diagrams or more traditionally at the end of modeling just before programming will 
take effect. Activity charts are frequently used to document the logic for modules and methods. We will 
look at activity charts in this chapter. 

INTERACTION DIAGRAMS: 

• Sequence Diagrams - Sequence diagrams shows the order of messages sent between objects and the 
methods they will be activating. Sequence diagrams can be very useful in identifying class methods and 
identifying the timing element We will not cover at sequence diagrams in this eBook. 

• Collaboration Diagrams - Collaboration diagrams describe the sequence or interaction sequence between 
objects. Using numbers to document the order, collaboration diagrams layout the order of class object 
communication. Working much like a connect the numbers, collaboration diagrams use an outline like 
numbering sequence to identify the order of tasks and sub tasks (via class objects). 
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IMPLEMENTATION DIAGRAMS: 



• Component Diagrams - The component diagram show dependencies that exist between software and 
other system resources (i.e. databases, web services, etc.). This diagram is useful in planning for program 
implementation. We will not cover component diagrams in this eBook. 

• Deployment Diagrams - The deployment diagram is also used to document system dependencies for a 
physical or hardware perspective. This is also a diagram that we will not cover in the eBook. 

UML is a tool used by a number of people within the information systems organization. We will focus on those 
diagrams that will be most important to the programmer. 

WHICH UML DIAGRAM TO START WITH? 

There are mixed theories as to which of the UML diagrams you should start with. If the project is a system that is 
being developed from scratch and much of the requirements will need to be acquired from the end users, then 
one approach might be to start with use case, state or activity diagrams which focus on logic and business rules. If 
the project is an application where logic is reasonably straightforward but where many new class files will need to 
be constructed, then the approach might be to start with class diagrams. Finally, there's also an option where you 
as the programmer are more the recipient of the UML files then the designer of the model. Many times, in large 
corporations, the systems analyst takes care of the diagramming of user requirements. From the UML diagrams, 
program specifications will come. As the programmer, you will need to implement the diagram into a program 
with a programming language. 

From my perspective, I prefer to start with the use case diagram to give me a high level picture of the problem to 
be solved or the requirements to be implemented. From there, we move next to either a sequence diagram or a 
class diagram. This will allow me to give some structure to my solution but not yet focusing only on details. It's 
been my experience that you want to approach your users first with high level requirements and include them in 
the foundation of what you're designing. Once this foundation has been generally agreed on, I like to finish my 
work with the user in UML models with an activity diagram. This approach is not totally different than what can be 
accomplished with flowcharts and pseudo code. 

As the models are reviewed and refined, details begin to emerge that become the programming statements that 
will ultimately serve as the solution. This drill down approach of generalized requirements to specific details is just 
one approach that can be used with models. Most importantly, it makes no difference whether it's UML or 
structured programming models, you first must create a model and then refine the model to the point where 
specific logic can be reviewed by both the user and the programmer to ensure that the final solution in fact meets 
the desired requirements. 

Status Check 

Can you identify the purpose of a use case and class diagram? 
Which of the UML diagrams is closest to our flow chart? 



Background Information: UML Diagramming Tools - Software or Pencil and Eraser - Like most programming tools, 
UML diagramming can be supported by a variety of software tools. You can use some old favorites like Microsoft 
Visio or take advantage of some free open source products like Poseidon (a product of Gentleware Inc). But as 
always with these tools, there is a tradeoff. To get the formal and professional looking diagrams you'll need to 
learn how to use the software products. These products typically are more than just tools for UML diagramming 
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and also include use of extensive databases that facilitate the checking of diagram errors and the creation of 
source code. It is these functions that can make the products difficult to use. Even w/ith their attempts to include 
wizards and drag and drop interfaces, you will still be able to build diagrams faster with a pencil, eraser and paper. 
Depending on the extent of your reliance in the functions and features offered by the software programs, you have 
to decide which approach is best for you. At this stage of your programming training, you have many concepts to 
learn so your time might be best spent understanding the icons and techniques of creating the UML diagrams and 
leaving the UML graphics software for a later date. In this eBook, I have chosen to use UML modeling software to 
create my UML diagrams but it may be better for new users to focus on the diagram with a pencil and piece of 
paper. It has also been my experience the UML diagramming software works best if the user has the time to learn 
and practice the software. If you are only occasionally creating UML diagrams, pencil and paper is probably best. 



USING THE UML CLASS DIAGRAM 

The UML Class diagram has multiple uses but is probably most useful in the very beginning and the very end of 
systems design. At the very beginning, a class diagram allows you to organize class members based on 
requirements analysis (i.e. use case actors frequently become class objects). A class diagram developed early in the 
modeling process can help you organize your thoughts as you move through more detailed UML diagrams. 

Class diagrams also have a role at the end of the design process and just before we begin detail design. Class 
diagrams represent an excellent source of program specification logic for the programmer who has to implement 
the class file within a programming language. From a Class diagram, all instance and shared variables and methods 
are easily identified along with the scope of these variables. The bodies of the methods are not defined in the class 
diagram but the all important method headers are. 



ICON - THE CLASS SYMBOL 

The class diagram includes many class icons. The class icon is essentially a box with three sections. The top section 
contains the class name, the middle section contains the attributes with their scope symbol (+, - #). In the lower 
section, the methods are identified with the method header and scope modifier. The class diagram also had a 
variety of line connector and arrow points each identifying a different relationship or function. 

ATTRIBUTES 

The attributes of a class diagram represent the instance variables and shared class variables. Attributes are named 
to describe what they define and based on operators are identified as being either private (with a "-" ), public (with 
a "+"), protected (with a "#") or shared (with + and the attribute name underlined). Attributes appear in the 
second section of the class diagram below the class name. 

OPERATIONS 



The operations are the methods and events defined within the class file. The operations include a scope modifier 
(scope modifiers are also +, -, #), a list of input parameters (if applicable) and a list of outputs returned (also if 
applicable). Operations appear in a box below attributes at the bottom of the class icon. 

RELATIONSHIPS 
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INHERITANCE 



Inheritance is represented the class diagram by connecting two classes with an open arrow which points towards 
the parent class. Inheritance is also known as generalization in a UML class diagram. This relationship is referred to 
as a "is a" relationship (i.e. employee is a person). Inheritance has been covered in previous chapters and quite 
often is described as a parent child relationship (i.e.. Book class would be the parent of the magazine, soft cover 
book class and hard cover book class since all are a child versions of Book). 



AGGREGATION 



Aggregation represents a whole part relationship where a class or classes are owned by another class. For 
example, an Automotive Dealership class might be made up of aggregate classes such car dealership, a truck 
dealership and a motorcycle dealership). Aggregate relationship are often defined as "has a" relationships' (i.e. An 
Automotive dealership has a car dealership, a truck dealership and motorcycle dealership). The aggregation icon is 
an arrow with an open diamond at the end of the line that touches the whole class (.i.e. auto dealership). 

ASSOCIATION AND MULTIPLICITY 

An association is a straight line connecting two classes that have a relationship with another. Multiplicity 
documents how many objects can participate in the association (i.e. one to one, one too many, many to many). For 
example, there is an association relationship between the Customer and Book Order. This relationship can also be 
identified by the number of participating objects from the perspective of each object. A Customer may have many 
Book Orders but each book order has only one customer. This would be represented in the diagram with the 
number one printed where the association line connects to the Customer (representing one order per customer) 
and the letter n printed where the association line connects to the book order object (representing each Customer 
may have many Book Orders) 



association - A generic relationship between two classes that also documents multiplicity that indicates the 
number of objects that participate in the relationship (i.e. one to one, zero to many, one to many, etc.). 



Below, I have drawn a class diagram to represent inheritance, association, and multiplicity along with class icon 
syntax documenting class members of the Customer, StoreCustomer, ~On-LineCustomer and ~E-Books objects. 



CBTPayrnent 
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Figure 2: Class Icons Diagram 

USING THE UML USE CASE DIAGRAMS 



Use case diagrams generally consist of three different icons. One icon is called the actor and represents persons or 
systems which interact with the system. It is from the actor's perspective that use cases are developed. Each use 
case represents a function or business process that the system must provide, (i.e. Select a book, purchase a book, 
returning book, etc.). Use case diagrams are conceptual and are typically the first iteration done in a very high level 
with little detail or specifics. It is not unusual for the first use case diagram to be a context diagram which identifies 
only the major components. As interviews with the user and reflection upon the diagram take place, use case 
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diagrams become more specific wliere other use cases are identified and associated witli a parent use case. Many 
developers will take these specific use case diagrams and expand on the logic further with activity diagrams or 
initial design of class diagrams. 



Logic Tip: Use cases are frequently business processes of the organization 



Actor - Actors are users or systems (i.e. accounting system, inventory system, etc.) that interface or use a system 
function (or use case). 



Use Case - Use cases represent a feature of function required by a systems actor. 

Use case diagrams can be designed to show a drill down picture of how system functions can be broken up into 
additional functions or subsystems. For example, a use case might define a purchase of a product. At its highest 
level, this is a valid use case. However, a purchase is more complicated than that and may actually include some 
functions or sub use case models which identify the components of that transaction (i.e. input of customer data, 
verify product is in inventory, contact the credit card company to validate payment). 

The use case diagram is a critical tool used for requirements definition and represents an excellent way of defining 
scope and isolating the functions that a system needs to support. We all have heard of nightmare scenarios where 
a company has spent millions of dollars on a new system all lead to find that system does nothing like what 
requestors actually wanted. A well thought out and complete use case model provides for an excellent insurance 
policy that the programs created are what was requested. 

Use case models are also the easy to communicate to the end user and therefore are an excellent means for 
including that user in the design process. Everyone likes to be included in the act of including them and making 
them part of the design process improves the chances of their buy in and support later on. 

USE CASE ICONS (ACTORS, USE CASES AND SYSTEM) 

The use case is represented by and oval on its side that includes text inside to describe the use case. Actors can be 
people or things that interact with each other through use cases. An actor can also be an accounting system or 
inventories system. An actor is represented as a stick figure that has a head, arms and legs. Around use case icons 
is typically a rectangle which documents what is included with the system. When the rectangle closes actors and 
use cases, they all belong to a system. Lines are used to connect the actors to use cases in UML use cases to other 
use cases. A solid line is used to represent an association or a dash line is used to represent a relationship (i.e. 
includes and extends) between use cases. 
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Figure 3: The Actor, Use Case and System Icons 



<> AND <> ATTRIBUTES 

Use case diagrams also take advantage of some techniques that we have seen in the development of class files. 
Use cases can support associations. Included within the diagram maybe the printed text <> or extends. <> which 
indicates that the use case has a sub function or sub case which is used in one or more use cases. For example, a 
use case involved with invalidation, perhaps to accept or reject a credit card transaction. That use case may have 
to be executed on purchases and on credit when merchandize is returned. The <> keyword indicates that I have 
extended a use case with additional function not found in the base use case. This is similar to a parent child class. 
The child class has more detail than the parent. 

<> and <> Attributes - <> and <> are sub use cases and represent shared use case function, in the case of the <> 
attribute or add additional function to a base use case in a new use case identified with the <> attribute 

ACTIVITY DIAGRAM 

Activity diagrams are used to represent business rule logic. Like many of the UML diagrams, activity diagrams can 
be used in a high level or a very detailed level. At a high level they can be used to help clarify use case diagrams 
and at a low level they can represent the last stage of modeling before programming. The diagramming icons and 
techniques for activity diagrams are very similar to the flowchart. 

I ACTIVITY ICONS 

Each activity diagram stars with a solid point which identifies the starting point. What follows is an activity icon, 
decision point icons, transactions splits and finally concluding with an endpoint icon. Between each icon is a solid 
line with an arrow indicating the flow of the logic. Activities are labeled with terms to describe the business rule or 
process. The diamond symbol identifies the decision point with a split labeled to identify the two decision options 
(much like the diamond symbol in a flowchart). Transactions puts are drawn as parallel lines across the diagram to 
indicate that one of more processes can be processed in parallel (or at the same time). 
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Figure 4: Activity Icons 

Here we have an activity diagram documenting the logic present in an earlier case study. 



Logic Tip: Activity diagrams take the business processes identified in use cases and further define those processes 
in terms of business rules. 



UML DIAGRAMS - A SAMPLE PROJECT 

Before we start the sample project, it is important again put in perspective the fact that UML usually works best for 
the design a new systems. Starting with the use case diagrams that help spell out requirements and then moving 
towards activity diagrams and class diagrams to identify details, the UML diagrams in this example project will 
identify the logic model just prior to logic pseudo code. This is not to say that UML cannot be used for detail design 
but that it's outside of the scope of this eBook and would not have the time to investigate UML to the level of 
detail necessary to create source code. 

Since UML modeling spans not only program design but also requirements analysis, I have chosen not to go back 
and create UML diagrams from previous pseudo-code used in other examples. One of the important aspects of 
using a methodology like UML is that the solution should not creep into the requirements, especially a previously 
designed solution. You should also use your UML models with the end users of the program to make sure 
requirements are defined correctly. It is important not to rush to specifications when fact finding a requirement. 
For this reason, we will use a business that we're familiar with. Cactus Books and Tapes, but not the ecommerce 
site application we have been using in our case studies.. 

In this business scenario, Cactus Books and Tapes are looking at the development of a program that will download 
from a store kiosk audio books formatted in an MP3 file format. MPS players are becoming more common with 
customers who use these small devices store music and audio books. Selling and renting books on tape has always 
been an important product for Cactus Books and Tapes and it's only logical extension for the store to now offer 
MPS files to be downloaded to these portable compact devices. To minimize the cost and provide the best value 




Designing Class Objects | http://laptoppress.garymarrer.com 



for its customers, the Chavez sisters have decided that a PC Kiosk located in the audio book section of the store, 
could easily be used to download MP3 files from the audio tape inventory in the store. 

COLLECTING REQUIREMENTS 

There are many ways to start systems designed with UML. An approach that I have found to be effective is to start 
with use case diagrams to define requirements. Defining requirements are important raw material necessary to 
designing a system that meets the end users requirements. With use case diagrams as our starting point, our first 
activity in the requirements analysis is to identify the actors interfacing with this system. In interviewing the 
Chavez sisters, the initial actors identified have been the customer, the bank which processes the payment and the 
accounts receivable system which keeps track of the sale. 

Once we have established the actors which I will shorten the actor names to customer, bank, accounting. We then 
need to look at each actor to identify which use cases when applied to them. Each use case is an identified 
function that the new system must possess. At this step In the process of developing our use case diagram, I would 
want to only identify the highest level functions of the system and avoid trying to formulate details until they use 
cases can be discussed with the end users. I do not want to buy its might use case with my perception of how the 
system should work. Although that may have experience with this type of system, it's important that I let the 
process developed naturally so that the creativity is not lost through any personal bias. 

For our cactus of books and tapes application, we have identified the use cases as follows: 

• Search for audio book 

• Browse for audio book 

• Add audio book purchase to shopping cart 

• Check out shopping cart 

• Download audio book 

This list of use cases would represent our context level view of the new system. These would be the major features 
and functions of what we want to develop. What's missing at this point is the details and as we refine and revisit 
the requirements with the end user, we will begin to extract a more detailed view of what needs to be developed 
if the system is to be successful. 



272 



Designing Class Objects | http://laptoppress.garymarrer.com 



Cocyrlghlcd matenal 



Cactus Audio Tape Kiosk Ordering 
System 




This diagram rspr^ente a top lavsl view of system raqjlrerrwnls from the actor perspectives. 



Figure 5: Top Level Use Case Diagram 
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REFINING AND REVISITING OUR MODEL 



From our high level context use case diagram, we now need a analyze It to identify sub-tasks or more use cases. 
This is not unlike modularization that we covered in it earlier chapter where we took our programs and tried to pull 
from them some functions that would stand by themselves. There's no rule as to how many use case icons and 
actors must be involved in creating requirements analysis except that there must be enough © . Obviously, as the 
diagram becomes more detailed, so does the possibility of the use case diagram becoming confusing and difficult 
to read. It is wiser to break up the diagram over several sheets of paper repeating actors when necessary to make 
sure that all use cases are identified with plenty of room in the diagram to space out other use cases if needed. 

At some point, and this point is one that is discovered more by experience, we move from requirements and begin 
to see a design taking shape. There are several schools of thought as to the next step. Some developers will argue 
that this point class objects begin to appear based on data requirements or data manipulation defined within the 
use cases. Other developers will say that state and sequence diagrams provide necessary guidance as to how use 
cases integrate with each other. In the case of this eBook, our next step is to focus on activity diagrams. Activity 
diagrams represent the unbundling of a particular use case into a series of modules. Modules like we have 
discussed them in the past that represent individual clearly distinguishable sub-tasks. 



Custoiiner 



Figure 6: Detailed Use Case Diagrams 



DESIGN WITH UML 

Activity diagrams have many similarities to some of the steps defined earlier in the eBook when we discussed 
modularization and the construction of flowcharts. An activity diagram will start by focusing on one of the use 
cases. This use case will represent one of the systems functions. We will take this one function and break it down 
into a series of tasks. Each of the tasks will exist as an activity and at the top and bottom of the list we will use an 
open and close circle (or dot) to indicate the start in the end of the activity diagram. As we moved from activity to 
activity, we place special attention to determine if a decision is involved and whether or not that activity is 
included or excluded from the function we are defining. For example, if a customer becomes uncomfortable with 
the audio book purchase and has concerns about whether to continue, then they may decide to exit the system or 
continue on with their purchase. These options all identify alternatives which must be integrated into program 
logic. The activity diagram allows us to identify decision points (with a diamond symbol). Our activity diagram will 
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also allow us the ability to Identify activities which can happen in parallel and activities which much act in 
sequence (or are dependent on other activities). 



For the Cactus Books and Tapes case study, we will isolate on the use case identified as cart checkout. Cart 
checkout involves taking those items selected by the Customer, adding the total cost of the transaction along with 
sending that transaction to the credit card company for processing. 

The activities that we've identified as part of the car checkout process are as follows: 

• Verify cart has items purchased 

• Total all cart items 

• Calculate discounts 

• Calculate state tax 

• Calculate purchased total 

• Post transaction with credit card company 

• Post transaction with accounts receivable 

• Print paper receipt 

The following activity diagram takes those activities include the appropriate position points that will further define 
program design logic. 



■No 





Figure 7: Activity Diagram 
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PREPARING FOR PROGRAMMING 



We have saved the best for last. Although UML has nine diagrams to model a system, we have condenses the 
process to just three diagrams. They use case diagram was used to give the application structure and define the 
scope of what needed to be included within other UML models. This was done from the perspective of the people 
who are using the system or interfacing with it. We next isolated the features identified by the actors in detail and 
divided them into sub-tasks which roughly serve as the equivalent modules/methods. The last part of the process 
requires us to look at both of these sets of diagrams to identify what we think the class objects of this system will 
be. Again, we are working with conceptual models that have yet to be turned into logic and programming 
statements. It is very possible that the models we develop may look different than the finished program code. 
Even with the differences, the fundamental logic of the UML models will carry over to our program logic and even 
though the logic may not be exactly the same it will be very close. 

I like to start my class diagram by investigating the actors. Actors represent "things" in our model. We know from 
our definitions of class objects that classes are also supposed to represent "things". We need to look at the activity 
diagrams to isolate areas where data needs to be stored or manipulated as part of the programming logic. If the 
data can be grouped in associated with a "thing", we have the start of our class object. Once the class object data 
has been identified we can now look through our activity diagram to isolate those methods that can be associated 
with the class object. Again, we need to return to our definition of class objects and understand if they contain 
members of both data (called attributes) and modules (called methods). For the purposes of brevity we have had 
to condense this example and simplify both the application and the detail in the models. In the model, I show four 
classes in this same application along with the relationships (3 with association and 1 with aggregation) but in I am 
sure with more analysis there would be more. 



CBTPaymant 

-stofeN umber : string(idl) 
-transDate : string(ldl) 
+payment() : doublefidl) 



Figure 8: Class Diagram Example 

RUNTIME PROCESSING - EXCEPTIONS 



We've already discussed that there are three errors that typically occur when programming applications. The first 
type of error is a syntax error and is associated with programming statements that cannot be converted to 
machine code by the compiler or executed by the interpreter. Another type of error is logic errors. Logic errors are 
statements which compile and execute correctly but in fact have some logical error within the statement that 
causes the program to come up with the incorrect answer or not execute the correct option. The last type of error 
is a runtime exception. A runtime exception happens when the program takes a valid statement that has been 
processed by the compiler and tries to execute it. During execution, something within the statement is an error so 
that the operating system is unable to complete the instruction. Sometimes these types of errors occur because a 
program input. For example, if you have a statement which accepts input to divide into another number and the 
number input is a zero, the statement will cause a runtime error because the computer cannot divide by zero. 

Run-time errors in most of contemporary program languages are called exceptions. Most programming languages 
have several common system exceptions already defined (i.e. divide by zero and array subscript out of range). If 
the programmer wishes to recover from a runtime error without having to restart the program, then they can 
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process these runtime errors with control statements that allow the person using the program to make the 
necessary changes to continue to operate the program. For example, if we go back to the example I just discussed 
regarding divide by zero. As the programmer, you need to anticipate exceptions. Divide by zero is a system 
exception that could potentially happen when the user inputs a zero for the divisor. Your program could loop until 
the input is successful (i.e. no zero). If the input caused a runtime error, and your program identified the possibility 
of that exception, you could process the exception by allowing the user to key in a new valid value. This way the 
program completes and does not abort with a run-time error. 



Run-time error - runtime errors occur when the program runs into a statement that it cannot execute causing the 
program to abort. This is typically caused by the input into the program by value which is inconsistent with its logic. 
Common types of runtime errors are dividing by zero in trying to access a subscript that does not exist. 



Exception processing is implemented in most languages with try/catch processing. This involves the creation of a 
try block followed with one or more catch blocks. The try block identifies those statements which will be evaluated 
for potential exceptions. If an exception occurs on one of the statements included within the try block, it is said 
that an exception has been thrown. The thrown exception is then sent back to the try block to see if any 
subsequent catch blocks are associated with the exception thrown. If a catch block is associated with that type of 
exception, then the code inside the exception block handles the exception and processing continues. In other 
words, if the programmer anticipates a runtime error, he can isolate the error producing code with a try block and 
create a specific catch block to handle the processing of the runtime error (the display of an error message and a 
path of code to allow the user to recover from the error). 

What this means for the programmer is that they must anticipate what the potential runtime errors that might be 
returned from the statements that have been just executed. If the statement is a calculation or a variable is used is 
used as the divisor, this would be an excellent candidate to have a catch block to trapping the exception thrown on 
a divide by zero exception. Once a catch block has matched the exception and processed its logic, the other catch 
blocks are ignored. 

An exception can only be processed by one catch block. In some programming languages, there is a special catch 
block which acts like a wildcard catch block. For this type of catch block, it can catch any exception thrown. Quite 
often it exists as the last catch block to catch any unresolved exceptions. It will usually print a message letting the 
user know that the program has ended with an unknown error. Usually, the message will let the use know to 
contact the programmer know that the program aborted and that there is at least one more exception that needs 
a specific catch block assigned to it. 



try block - the try block starts with a try keyword identifies statements that will be evaluated for run-time 
exceptions. The try block exists before the one or more corresponding catch blocks. 



catch block - the catch block provides runtime exception handling. There's typically one catch block For average 
type of protected exception that part of the program may throw. Catch blocks are coded just after the try block it 
is handling exceptions for. 



Programming Tip - Catch blocks are like methods in that they consist of a block of code statements. 



Related Subject: Some typical runtime exceptions - Divide by zero is probably the most common runtime 
exceptions thrown by the operating system or virtual runtime environment (i.e. Java virtual machine or Microsoft 
Common Language Runtime). There are others that frequently occur and potential problems you should prepare 
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for in your logic. Two in particular are very common. If your program contains arrays, it's a common programming 
mistake in not taken account the fact that most arrays start with element zero. If your program accepts input in 
uses this value to help determine the element it's possible that you might go one beyond the last element in the 
array. If this happens, an array subscript out of bounds exception is thrown. A good rule of thumb is that if your 
program contains arrays chances are you'll want to do try catch processing looking for the out of bounds exception 
on an invalid object. 



If your program is going to have to open text files or databases, you'll want to make sure that you do try catch 
processing on the file open statement. If the file has been moved or if the user did not locate the correct file, an 
exception will be thrown of that file needed by the program is not found. Given that most programs allow the 
users to select files. This is also another likely place for tri catch exception handling. 

Each programming language has a slightly different way of handling these exceptions but PYTHON is very similar to 
how Visual Basic. Net and Java handle exceptions. Below the sample PYTHON program creates a ZeroDivldeError 
and handles it in a catch exception. 



Related Subject: OOP - Not a spectator Sport - As we finish up our final chapter on object oriented programming, 
many of you may still feel like you have a lot to learn. That light bulb event that we had talked about earlier may 
not have happened quite yet. The important thing to remember is that OOP is not a spectator sport. To 
understand how this programming technique works, you must spend the time creating models implementing 
programs and returning to the book and other resources to continue to clarify and understand the principles 
behind class objects. I assure you, that with practice, you too will have that light bulb event when everything 
comes together. It will all of the sudden come together and you will wonder how you missed it the first time. 




You have noticed in previous case study programs that on occasion there have been runtime exceptions thrown. 
Runtime errors are first of all embarrassing for the programmer (i.e. you should have found it before the user did) 
and secondly bad for the program. With a runtime error left unhandled, the program will abort and return back to 
the operating system. This means that any input already keyed to the application by the end user will be lost and 
they'll have to not only restart the program but also put the data back into that program. As the programmer, you 
want to examine your code and identify areas in your program code that potentially could cause a runtime error. If 
the runtime error is identified, it's a relatively easy matter to create the appropriate code to allow the user to 
receive an error message indicating the problem and also a prompt or input box to correct the error so that the 
program can continue uninterrupted. 

We will examine the program used in a previous chapter on array processing to try to isolate those programming 
statements which would be good candidates for try/catch processing. 

In this previous program, we use two parallel arrays (itemCost and itemCode) to look up the wholesale cost of a 
book from its itemCode. A runtime could occur if you try it access an element outside of the array. In the example 
for this case study, the arrays are unbalanced and not parallel. When the last element of one array points to the 
last element of the parallel array, that element is missing and because of this, the program tries to access a 
subscript out of range. 

CASE STUDY TASKS: 

• Review the following program for areas which could potentially return a runtime exception. In the 
program code create additional logic to report the error message and allow the user to resume the 
program without interruption. Both pseudo-code and PYTHON will be presented in this example but only 
the PYTHON code will be modified for the exception handling. 
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Original Pseudo Code for WholeSaleCost module 



wholeSaleCostO 

searchVar = 0 
foundValue = 0 

itemCodeArray["1001", "09921", "23", "13123", "5544"] 
itemCostArray[23.50, 4.90, 15.25, .90, 4.90] 
Input itemCode 
O for searchVar = 0 to 5 

if itemCodeArray[searchVar] = itemCode then 

foundValue equals itemCostArray[searchVar] 
return foundValue 

return 

- In this part of the program, you see the for loop that performs the linear search. 

If the search is successful and the value we are searching for is contained within one of the elements, the value is 
stored in a variable called foundValue and then returned back to the program for printing. 



PUTTING IT TO USE 



The intent of this section is to introduce the new programmer to standards and techniques frequently used by 
professional programmers. Topics in this section relate to concepts introduced in the chapter but with a more 
vocational or occupational focus for students considering a career in programming. 



CHAPTER REVIEW 



Chapter summary, highlights, key terms, short answer questions, quizzes and case studies to reinforce topics 
covered in this chapter. 

CHAPTER SUMMARY 

After finishing this chapter you should understand and in some cases, demonstrate the following topics: 

• Describe and explain the important elements of implementing effective class object reuse across different 
computer platforms. 

o The programmer writing reusable code needs to make sure that they create class file that will 
work with a variety of computer platforms (i.e. PC desktop, PDA, Cell Phones, etc.) without 
modification 

o Try/Catch block processing with custom exceptions provide a methods for implementing class file 
reusability by separating the user interface from the class file. 

o Explain and demonstrate the logic modeling using Object Oriented programming techniques. 

o Like programs developed using structured programming techniques. Object oriented 
programming that use models provide more effective and efficient solutions. 
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o Conceptual models provide an excellent way of including the user in the development of 
requirements by allowing a "best case" model to be developed. 

o Physical modeling involves talking conceptual models and implementing them as programs. 

• Demonstrate the design of logic and programming using Object Oriented Programming techniques. 

o Programmers developing for code reuse with object oriented programming languages like 
Unified Modeling Language model and document class objects before implementing as program 
code. 

• Define UML and recognize logic modeling diagrams and their roles in modeling class object data and 
processes. 

o Use case diagrams help us identify business processes from the eyes of the users or the system 
actors. 

o Activity diagrams help use identify programming modules and methods, 
o Class diagrams provide the specifications to build program class objects 

o There are a total of none diagrams included with UML version 1.5. They diagrams allow you to 
model the program development and deployment process. 

• Define and recognize runtime exception errors and the handling of those errors. 
CHAPTER KEY TERMS 

Actor 

Association 

Attributes 

Catch Blocks 

Conceptual Design 

Exception 

Extends 

Includes 

Inheritance / Generalization 

Multiplicity 

Operations 

Physical Design 

Runtime Errors 

Try Block 
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UML 



Use Cases 
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PART 4 INTRODUCTION TO OBJECT ORIENTATED PROGRAMMING 



CHAPTER 11 FUNDAMENTALS OF EVENT DRIVEN PROGRAMMING 



IN THIS CHAPTER, YOU WILL LEARN HOW TO: 



• Explain fundamental concepts of event driven programming environments and the connection between 
text and grapliical user interfaces and event processing. 

• Differentiate between event driven programming and sequential processing environments. 

• Demonstrate the design of logic models for event driven programming applications. 

• Explain the connection between registering and handling events and the lifecycle of an event. 

• Describe common trapped events found in text based interfaces. 

• Describe design and testing concepts used when developing event driven programs. 



EVENT DRIVEN PROGRAMMING FUNDAMENTALS 



This chapter marks the start of the section on event driven programming. With the advent of graphical user 
interfaces (GUI) and their popularity, most programs today are designed to be interactive capitalizing on 
graphically rich operating systems where the user interacts with the program logic via icons and graphics. Whereas 
programs covered in earlier chapters focused mainly on the sequential processing of logic, event driven programs 
are typically controlled by the end user where the sequence of operations is partly under the control of the 
programmer and partly under the control of the user. When the end user clicks on graphical controls or uses a 
shortcut key to execute a selection in a pull down menu, the program then responds to that event or action. The 
event initiates the execution of a block of code reflecting some piece of the program associated with that event. It 
has been in the introduction of graphical user interfaces that has popularized event driven programming. In our 
discussion, we will approach this program design from two directions. We will look at event driven programming 
with text and graphical programming interfaces. 

In this chapter, we will first focus on the coding of applications that respond to keyboard events. The topics 
covered will highlight the mechanics of event processing without graphical controls. We will still be able to use 
pseudo code to model the logic and PYTHON to validate our model design. 



Event driven programming: Event driven programming consists of designing program logic that partly depends on 
user interaction to control program execution. The user triggers an event by clicking on graphical controls or keys 
on the keyboard. Each event is tied to an event handler that is associated with a block of program code. An event 
might be hitting the Q key and the event handler code for that key might be code to quit or end the program. 



Part 4 Introduction to Object Orientated Programming | http://laptoppress.garymarrer.com 



Sequential Processing - When a program uses sequential processing, statements are executed in sequential order 
from top to bottom (much list the way we read a book). The only exception from the top to bottom sequence is to 
call a module. When the module is called, execution moves to the module and returns back to the call point when 
all of the statements in the module have been executed. We have used sequential processing in our previous 
chapters. 



Event - An event is an input action that is caused by clicking on a graphical object with the mouse, hitting a key on 
the keyboard to select an option or signaling an event as a result of programming logic (i.e. for example the result 
of a if statement decision structure). 



Graphical User Interface - Also referred to as GUI (pronounced Gooey), a graphical user interface consists of 
graphical objects such as icons that are used by the end user to interact with the operating system. Perhaps the 
most famous GUI program is the Microsoft Windows desktop. A program can also have a GUI and it also uses 
graphics and icons that allow the user to control the application. 



What makes this final section so important to your training is that event driven programming represents a design 
that is favored by most users. As we have adopted graphically rich operating systems like Microsoft Windows, 
Apple Macintosh OS and Linux, and with the continued familiarity with graphical Internet browsers, users have 
come to expect their interaction with a computer to be much like interactive TV where multimedia graphical 
objects and input devices, like the mouse, control their use of the computer. 

In my programming classes, many of the students have never seen the older command line operating system 
interfaces which were available when personal computing first became popular. Since the introduction of a 
Microsoft Windows operating system environment in 1990, anyone who has any experience with a personal 
computer probably only knows a graphical interface. Although event driven processing is associated with the 
newer operating systems it was possible and was popular to create event driven programs without a graphical 
interface and only a command line prior to MS-Windows. 
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Figure 1: Screen Shot Command Line (DOS prompt) 
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Figure 2: Graphical User Interface (Visual Basic Program) 



Command line - Most operating systems provide a command line prompt to signal the computer is ready for input 
(instructions or commands). The command prompt is used when a graphical interface is not needed or available. 
This input could be the execution of a program or a request for program input (a prompt asking for input to supply 
a value for a variable). 



Our first exposure to event driven programming will be done using the techniques learned in earlier chapters. 
Since all of the PYTHON programming we have done to this point has been from the command line, event driven 
programming in this chapter will graphically not look much different than what we have done in the past. What we 
will do in this chapter is learn to take text based application environments and implement event driven 
programming with keyboard events. Our next chapter will focus on topics which relate to visual programming 
environments. In this chapter, we won't see icons and graphics whereas in the next chapter we will spend a lot 
more time on screen design and the effective use of graphics in interacting with the user. 



Programming Tip: Event driven programming can be implemented in both text based command line interfaces and 
the more modern graphical user interfaces. 



Background Information: Event driven interfaces better? - Just like we discussed when we introduced class objects 
into our programs, event driven interfaces do not necessarily represent the only way or the best way to write the 
program. A program that uses an event driven processing design works internally no better than a program that 
uses a sequential design. Sequential processing gives us speed and simplicity, class objects give us reusability and 
events give us better interactivity with the user. Using one or all of these design techniques are dependent on the 
kind of solution you want to provide for your end user. 
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WHAT DO WE MEAN BY PROCESSING AN EVENT 



So far much our discussion has been dominated by interfaces. Graphical interfaces and text interfaces. Interfaces 
are important to events because for any event processing to take place the user has to see the options offered by 
the program. While the interface is displayed, the program is looping patiently waiting for an event to occur and 
then handled. 

By design, this is dramatically different than how we have done processing so far. In our previous programs, we 
researched user requirements and then designed our program to meet the user's requirements. We limited the 
user's control of the program. We are now giving the user choices. We now design the program to include all of 
the operations that satisfy the user's requirements but the control of the program is left with the user via the 
interface. This is implemented by providing the user an interface with options. Each option is an event and each 
event has its own logic module (and therefore part of the program) associated with it. 



Text Interface - A text interface uses text displayed across the entire screen to facilitate an environment where the 
user can't interact with a program by selecting keys from the keyboard that execute code blocks within a program. 



For example, the user may be presented a screen that has a various letter options. The act of selecting a letter 
corresponding to the desired option is an event. The program is listening for the event and handles it. Handling the 
event (also called event handling) means the program has code associated with the event. We are letting the user 
decide which option they want to take and therefore which direction the program will take. Again, we are giving 
up control for the sake of an interface that is more conversational and presents the user with greater flexibility. As 
we will see later in the chapter, relinquishing control of our program to the user means that the logic must be built 
to not allow the user to take an option that would cause the program to fail. 



286 



Event Driven Programming Fundamentals | http://laptoppress.garymarrer.com 



Test Interface - Event Driven 
Programming 
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Figure 3: Sample Text Interface, Event and Event Hander. 



Programming Tip: Programs can contain one or many events. 



THE LIFECYCLE OF AN EVENT 



Events are at tlie center of event driven processing and they iiave three stages which they move through. All 
events start with some registration process. When the event driven programming is initiated from a text interface, 
the program associates an event with a key from the keyboard. The registration occurs when program code 
associates and event action with a key. Once the event is registered, the program listens for that key to be clicked. 
Listening typically requires the program to be placed in a looping state where it is listening for an event to be 
trigger or fired. When the key is clicked it is said that the event is fired. In terms of the loop, the firing is connected 
to a Boolean expression which has been associates with code linked to the event. Once fired, the event must be 
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handled. Event handling means that code that has been designated as the event handler for that event. When and 
unhandled event has be identified the code associated with handling that event will be executed. Event handling 
code Is usually stored within a module associated with the designated role of the event in the program. 

Lifecycle of event handling performed in a text Interface: 

• Registering the Event - Identifying the key that is associated with the event. 

• Listening for the Event - Placing the program in a state to listen for the events to be fired 

• Event handing - Once fired, the code associated with the event is executed. 



Programming Tip: It should be noted that events can still happen within a program that does not have a text or 
graphical interface. This type of event is fired and responsive to a state the program has moved to. An example of 
this type of event processing can be seen at the end of this chapter. 



Background Information: Looking for Command Line Interfaces - My students give me a lot of strange looks when I 
talk about command line interfaces. Since most of the students, were brought up with computers that had 
graphical user interfaces (post 1990), the concept of a command line interface is something which needs further 
explanation. I explain to them that before the mouse and icons, computers were run with commands issued at a 
command prompt (or the command line). If you wanted to run a program then you would type that program name 
in at the command prompt and then hit enter. The program was then executed and reported back to the screen 
some text as the programs output. Programs were typically not as interactive and certainly not as conversational 
as we have with the graphical user interfaces of operating systems like Microsoft Windows. 



For those of you who would like to see a command line prompt in action, if you're a Microsoft Windows user you 
can access Accessories under the Program Menu list and then select DOS Command Prompt. The command 
prompt will consist of a window with a black background white foreground and a starting drive letter and folder. 



288 
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DOS Cammand Prompt in MS- 
Windows XP 



9 Command Piompt 





Figure 4: MS Windows Command Prompt Window Screen Shot 



Status Check 

What stages are in the event lifecycle? 

How is a text interface different than a graphical user interface? 



HOW DOES EVENT DRIVEN PROGRAMMING FIT IN WITH WHAT WE HAVE DONE SO FAR? 



For the programming of solutions that use a graphical user interface, event handling is critical to take advantage of 
the graphical objects (i.e. command buttons, text boxes, etc.) that control the program. For a program that has 
only a text interface, the effect is less dramatic. Event handling as a way of controlling the program that can make 
it more interactive. For most applications this is an advantage. The exception would be those applications that 
process large numbers of file maintenance operations (add, change and delete) or where user interaction is not 
necessary. 
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Related Subject: Event Driven Transaction Processing - Wlien we process data record by record from a file or 
database, this type of programming is called transaction processing. Usually in most business applications, when 
we are processing transactions, the records processed are in the hundreds or thousands. Although, event driven 
processing could be very useful for working on a record at a time (i.e. maybe for a customer service program that is 
used when talking to a customer on the phone), if we needed to process thousands of records, event driven design 
would not offer an advantage and it fact it would be a disadvantage. For those large update operations that 
involve a large number of transactions, we would probably choose a program design that uses a sequential 
processing design. 



EVENT DRIVEN PROCESSING AS A CODE PATTERN 

Event driven programming is performed with all of the techniques we have covered so far. It borrows a little from 
control structures (decisions and looping) and can also take advantage of class objects if code reuse is important. 
We have talked about many logic patterns in this eBook that qualify as code patterns. Event processing would 
certainly qualify as a pattern. 



Common Graphical Controls 

® Ofition Button or Radio Button 
0aieck Box 



Exit 



Cornmand Button 




Enter Text 



ListBoK 



Total Cost LatHlBox 

Figure 5: Basic Graphical User Interface Controls 

EVENT DRIVEN PROGRAMMING VERSUS SEQUENTIAL PROGRAMMING 

It is important now to compare and contrast a program developed with event driven processing and one 
developed using simple sequential processing. Let look at a simple sequential application that adds to numbers. 
Taking from concepts learned and earlier chapters we know that this type of program would require us to identify 
the least three variables. One variable to hold the total and the other two variables to hold the numbers that 
would be added together for the total. Our program might prompt us for the two values to be added together and 
the program would automatically display the answer to the screen. 
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Event driven design affords us some benefits that we don't see with sequential execution. In the first example, the 
programmer controlled program execution and determined when the user was asked for input, when the 
calculation would take place and when the program would end. The event driven alternative gives the control to 
the user and lets the user run the program over and over again. The user controls when the program is complete 
and needs to end. 

Which design is best? It is a good question and one I would like to answer. Both programs work just as well. From 
the standpoint of the program coming up with the correct answer, either solution is fine. Sequential or event 
processing makes no difference. Where one version has an advantage over the other may be due to other factors. 
If the program needs to be written for a wrist watch then program size is a factor and the sequential solution may 
the preferred design. If the program is being run from a graphical desktop then an event driven solution would be 
preferred. Graphical controls require that events be defined and event handlers be coded. Graphical interface 
designs are also preferred by users. 

MENU PROCESSING IN A TEXT INTERFACE 

Let's take a look at another example of text interface event handing. Menus are an excellent example of how a text 
interface can make the program easier to use. Before programs had mice and graphical interfaces, programmers 
would develop applications with a menu interface. Menus just like menus you would find in restaurants. You 
decide the option you would like and select it. This example builds upon concepts and techniques used in earlier 
chapters. The code used to build this design is no different than the code and logic structures used in earlier 
chapters. This application has an event driven code pattern to give the user a menu to select from. 

Let's look at the menu interface for program navigation. Rather than prompting the user for the selection why not 
print on the display all the menu options and let this user select one. When the selection is made why not trap the 
input and process that selection taking the user to the next screen. Is this not similar to what happens when a user 
uses the mouse to click on a command button to navigate to a new screen? In the following pseudo code and 
PYTHON examples, I have simulated an event driven application. I will create a pseudo-code logic model to put 
together the program logic and use PYTHON to implement the solution. 

Before we model the application, let's talk about what is essential if the program is to operate as an event driven 
application. First of all, I must design a text interface that fills up the entire screen (full screen interface). A full 
screen interface is where the display is formatted to use up all 24 lines of the display so that the programs text 
utilizes the entire screen. When the display takes the entire screen it facilitates the perception that the user is 
interacting with the application and not the command line (See screen shot below). The next step in my program is 
to create a while loop continues to loop until a menu selection has been selected (i.e. maybe Qto quit). We will 
call this loop the event processing loop. Within the loop, in each key entered is stored and processed through a call 
to the appropriate module. For example, I might have the menu selection 'A' for add, 'C for change, 'D' to delete 
and "Q" for quit. Once the letter is selected, logic in the event loop will call the appropriate module. 

Full Screen Interface - the full screen interface is accomplished when the user sees text painted across the entire 
screen as opposed to a command prompt waiting at the bottom of the screen. Visually, the user looks like they're 
interacting with the entire computer instead of just the command line. The text based interface uses full screen 
design to provide a more interactive environment for the programs user. 
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Health Kiosk Main Menu 

a. Search by Heal Calories 

b. Search hy heal Ti;pe 

c. Search by Cost 

d. Search by Prep Tine 

K - Return to Main tienu 

Enter Choice >> 



o 



Figure 6: Screen Shot Of A Full Screen Text Interface. 



Programming Tip: A command line interface can be converted to a full screen interface if print statements are sent 
to the display to clear any previous print statements. 



Pseudo code Menu Programming Logic 
start 

selection = "A" 

while selection not equal to "Q" 

selection = prompt("Enter Selection ") 
if selection = "1" then 

call clearScreen 

print "1 Selected" 
else if selection = "2" then 

call clearScreen 

call menuTwo 

end 

clearScreenO 

cnt = 1 

while cnt < 24 
print 

cnt = cnt + 1 

return 
menuTwoO 

selection = "A" 

while selection not equal to "R" 
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selection = prompt("Enter Selection ") 
if selection = "A" then 

call clearScreen 

print "Option A" 
else if selection = "B" then 

call clearScreen 

print "Option B" 

return 

Status Check 

Why is the event loop critical to an event driven interface? 

Why is filling the screen display with your text interface so important? 

DESIGNING PROGRAMS THAT USE EVENT DRIVEN PROGRAMMING 

The program that uses events sounds interesting but what are the ramifications. The ramifications deal mostly 
with the fact that as programmers we may have lost some of the control we had in deciding the sequence of our 
programming statements. As mentioned above, the number of statements and how they're programmed may not 
be significantly different but their execution is under the control of the person interacting with the interface. This 
can sometimes present problems for the programmer. For example, what if a program has three distinct parts? 
Each part of the program would represent some logic that is part of the total program solution. These three parts 
need to be executed in a sequential order. In other words, part one has to be done before part two and part two 
has to be completed before part three. If the programmer was to simply put key events on the text interface which 
triggered these three parts of the program, problems could develop if the user executed part three without doing 
part one and two first. The result could lead to a logic error or runtime error but in any case an error. This is a 
common problem when the control of the logic is built into the interface. 

As the designer of a program written to take advantage of event driven programming, there will be occasions 
where you may need in your design to deactivate or make keys inactive. For example, in the previous example 
where three parts had to be executed in order, the programmer might make the keys for part two and three to be 
invisible until the key associated with part one has been typed. The program has to design the interface to 
facilitate the sequence of logic contained in the program. 



Programming Tip: Programmers using event driven program designs need to use the interface to control sequence 
in which the user can activate program code from the screen. 



Related Information - Console Applications - Even programming languages noted for their ability to create 
graphical applications like Visual ~Basic.Net will support the development of a console application. A console 
application is essentially a program written to be run at the command prompt. Even Microsoft Windows, the 
operating system known for its graphical user interface, supports the command line interface called DOS prompt. 
DOS prompt can be found by default in the accessories menu option off of the programs list. Why I support the 
console applications? Some computers don't have a display (i.e. a smart card for example) and therefore if the 
programming language will truly support all environments and they will also have to support applications which 
can only run as console applications. 



What is asked of the programmer when developing event driven programs is not more complicated but different. 
In a sense, there's a tradeoff between the graphical nature of the program and the benefits associated with that 
versus the extra code that may be required in the program to control the sequence of program logic execution. I 
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think if we tool< a survey of users most would prefer to use a graphical interface program over a sequential 
program run at the command prompt. 



GUI EVENTS VERSUS PROGRAM EVENTS 

It is easy to only think of events in terms of the graphical or text user interface but this is incorrect. As you'll 
experience with learning programming languages that support event driven programming, it is also possible to 
register and handle events from program logic (the interface is not required). We have seen this already in chapter 
ten where in accessor method of a class object, we threw a custom exception which was handled by driver 
program. The custom exception was our event and the logic in the class file was the action that fired that event. 



Programming Tip: A common way that programmers refer to the registering of a new event is to say that that 
event was fired. Fired events are in turn handled which is to say program code is associated with each event in 
executed when the event is fired. 



If we will discuss the firing of program events in this chapter and leave our discussion of screen events to the next 
chapter. 

A LOGIC/PROGRAM EVENT 

Different programming languages handle program events in different ways. In Visual Basic there is an Event object 
that can be used to register an event and event handlers can handle a program event as easily as an event from a 
graphical control. The event is triggered with the raise keyword and the event handler kicks in automatically with a 
program sub procedure identified with the event handler. PYTHON can be programmed to perform in a similar 
fashion by utilizing custom exceptions. Since we have used PYTHON throughout the eBook, we will stay with 
PYTHON to demonstrate program throw events even though this approach is a little unconventional due to our 
liberal use of the exceptions. 



Program events - A program event is an event that's fired as the result of logic. Rather than being fired directly as 
the result of user interaction, a program event is fired as a result of program logic. Typically, this would be done as 
the result of an if statement some other decisions structure. 



For example, let's build an application that fires and event when the cost of an item exceeds 300 dollars. An if 
statement will be used to fire the event (providing the Boolean expression evaluates as true) if the cost exceeds 
300 dollars and a customer exception object will act as the event handler. The following example illustrates this: 

# P rogEve nth a n d . py 
#program event example 

class over300Event(Exception): 

def init (self, msg = None): 

self.msg = msg 
def _str_(self): 

return str(self.msg) 

#start of program 
cost = 300 
try: 

if (cost >= 300): 

print "Event fired..." 
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else: 



raise overSOOEvent, "Cost over 300 - Management Approval Required" 
print "Event not Fired..." 



except overSOOEvent, msg: 
print msg 

#end of program 

- The class overSOOEvent symbolizes our event and registers the event w\th the program 

- The try block enables the processing of exceptions and therefore our enables our event processing. 

- The catch block constitutes our event handler and is executed only if the event is fired due to the if statements 
Boolean expression. 

The following example should be contrasted with earlier examples where we used a text interface to allow the 
user to control the application. In this example, our program logic triggers events and how logic should be 
executed. One could argue (and probably prove with a program) a similar solution that used modules and if 
statement logic to accomplish much the same function as this program. Event processing logic is more functional 
when used with either a text or graphical interface. 

THE PROGRAMMING PROCESS WITH EVENT DRIVEN PROGRAMMING 

As we will see in both this chapter in the one that follows it, if we are developing an application which we know 
will be implemented in a graphical environment, we will certainly have to a take the event handling processing into 
consideration in our logic models. What this means is that the conceptual design still takes place and programming 
is still driven from our logic models, but what changes is an appreciation that an interface and the users selection 
of events will drive the execution of the program. The design process will have modules and code will be mapped 
to an event rather than to a tightly controlled sequence. 

DESIGN CONCERNS 

We have mentioned some of the concerns which are connected with event driven programming already but it is 
important that we review them one more time. For starters, most event driven programs utilize an interface 
(either text or graphical). We have spent many pages in this eBook emphasizing the importance of models. For the 
most part, our modules have been of programming logic. With event driven programs we also want to create a 
model of our interface. This is best done with a storyboard. A storyboard is a freehand drawing (or a drawing 
created from a product like Microsoft Visio) of the interface. If the interface is text based then the storyboard will 
have text. For a graphical interface, the storyboard will contain graphical controls. The storyboard should what the 
user will see when the application is created. See the example below for a simple text interface storyboard. 
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Main Menu 




(E) Edit and Existing Customer 
(D) Delete a Customer 

in] r lUUIalll ntflU 




(Q) Quit the program 




Enter A Selection (A,E,D,Q) 




AcrtK Inc. 


cij&tscrl 



Figure 7: Storyboard of a Text interface 



Storyboard - A story board is usually a drawing of the interface. The storyboard a prickly is used to lay out the 
graphical elements of the GUI. It would lay out the tax displayed on the full screen. 



TESTING 

Testing can be more challenging with programs that use events. Whereas a sequence program is controlled by the 
programmer, the event driven program is not. As the programmer, you will have to make sure your test matrix 
exercises all of the options (test cases) on the text interface and all the combinations that could be used on that 
interface. In the past we talked of the test matrix needing to focus on program logic. Since the interface allows the 
user to call out the sequence of the program logic, it is important that you exercise all of the user's options on the 
interface. 

A user will take some of the most outrageous and unbelievable approaches to your interface. You must test all of 
the interface possibilities to insure that even though the user has flexibility in choosing the execution path, that 
the sequence of their actions does not break the login in your program. As to determine test cases, place them in 
your text matrix to insure you have proper text coverage. 

Test Matrix - The text matrix is a grid that on the vertical axis documents all of the test case as necessary to 
exercise all the options of the interface. On the horizontal axis holds the outcomes expected from each test case. 

Status Checl< 

Does the program process change now that we are using a text interface? 

What special problems in program control does a program with a user interface have that a program without an 
interface does not? 
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CACTUS CASE STUDY 



One of the design goals of Cactus Books and Tapes was to make the program and interface as easy to use as 
possible. Customers will be reluctant to use a web site that is not easy to use and intuitive. Ultimately, the finished 
site will have graphical controls but for now you have decided to build a prototype of menu options to make sure 
that the interface options are clear. 

After talking with the Chavez sisters, you have come up with an initial design that, based on the sister's experience, 
will work well to capture key information. 

• Main Menu 

o Browse Books and Audio Tapes Screen 
o Search Books and Audio Tapes Screen 
o Checkout Shopping Cart 
o End Session 

• Browse Books and Audio Tapes Screen 

o Drama 

o Mystery 

o Sci-FI 

o Non-Fiction 

o Biography 

o Humor 

• Search Books and Audio Tapes Screen 

o Enter Keyword 
o Enter Title 
o Enter Author 

• Enter Book Type 
Case Study Tasks: 

• Review the following interface recommendations and create a logic model of the interface and options 



Cactus Case Study | http://laptoppress.garymarrer.com 



Cocyrlghlcd matenal 



Main Menu 




(A) Browse Books and Audio Tapes Screen 

(B) Search Books and Audio Tapes Screen 

(C) Checkout Shopping Cart 




(Q) End Session 




Enter A Selection (A,E,D,Q) 




Acme Inc. 


cuslscr! 



Browse Menu 




(A) Drama 




(B) Mystery 




(C) Sci-Fi 




(D) Non-Fiction 




(«) Biography 




(F) Humor 




(R) Return to Main Menu 




Enter A Selection (A,B.C.D.E.F.R) 




Acme Inc. 





Search Menu 




(A) Enter Keyword 




(B) Enter Title 




(C) Enter Author 




(D) Enter Book Type 




(R) Return to Main Menu 




Enter A Selection (A,B,C,D,R) 




Acme Inc. 


cus.tscr3 



Cactus Case Study | http;//laptoppress. garymarrer.com 



Figure 8: Story Board of Text Interface 



Pseudo code Solution 



start 

mainMenuO 
clearScreenO 

end 

ClearScreenO 
for i = 1 to 50 
print 

return 

browselVlenuO 
selection = "0" 
while selection not equal "R" 
call ClearScreenO 



pn 
pri 
pn 
pri 
pri 
pri 
pri 
pri 
pri 
pri 
pri 
se 



nt 
nt 
nt 
nt 
nt 
nt 
nt 
nt 
nt 

nt "R - 
nt 

lection 



Browse Menu" 



a. Browse Drama" 

b. Browse Mystery" 

c. Browse Sci-Fi" 

d. Browse Non-Fiction" 

e. Browse Biography" 



f. Browse Humor" 



Return to Main Menu" 



input(" 



Enter Choice >> 



if selection equals "a": 

call ClearScreenO 

print "Under Construction - Drama Selected" 
else if selection equals "b" 
call ClearScreenO 

print "Under Construction - Horror Selected" 
else if selection equals "c" 
call clearScreenO 

print "Under Construction - Sci-Fi Selected" 
else if selection equals "d" 
call ClearScreenO 

print "Under Construction - Non-Fiction Selected" 
else if selection equals "e" 
call ClearScreenO 

print "Under Construction - Biograpahy Selected" 
else if selection equals "f 
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call clearScreenO 

print "Under Construction - Humor Selected" 
else if selection equals "R" 
break 

else 

call ClearScreenO 

myDisplay = input( "Invalid Choice = Must be a, b, c, d, e, f, R ") 



return 



searchMenuO 

selection = "0" 

while selection not equal "R" 



pri 
pn 
pri 
pri 
pri 
ph 
ph 
ph 
ph 



nt "Search Menu" 
nt 
nt 
nt 
nt 
nt 
nt 

nt "R 
nt 



a. Search by Keyword" 

b. Search by Title" 

c. Search by Author" 

d. Search by Book Type (i.e. drama, mystery, etc.)" 



Return to Main Menu" 



selection = input(" 



Enter Choice >> ") 



if selection equals "a" 

call ClearScreenO 

print "Under Construction - Keyword Selected" 
else if selection equals "b" 
call ClearScreenO 

phnt "Under Construction - Title Selected" 
else if selection equals "c" 
call ClearScreenO 

phnt "Under Construction - Author Selected" 
else if selection equals "d" 
call ClearScreenO 

phnt "Under Construction - Book Type Selected" 
else if selection equals "R" 
break 

else: 

call ClearScreenO 

myDisplay = input( "Invalid Choice = Must be a, b, c, d, R 



return 



mainMenuO 

selection = "0" 
while selection not equal "Q" 
call ClearScreenO 



phnt "Main Menu" 
phnt 

phnt " 1. Browse Books and Audio Tapes" 
phnt " 2. Search Books and Audio Tapes" 
phnt" 3. Checkout Shopping Cart" 
phnt 

phnt "Q to Quit program" 
phnt 

selection = input("Enter Choice >> ") 
if selection equals "1" 

call clearScreenO 



Cactus Case Study | http;//laptoppress. garymarrer.com 



Cocyrlghlcd matenal 



call browseMenuO 

continue 
else if selection equals "2" 

call clearScreenO 

call searchMenuO 

continue 
else if selection equals "3" 

ClearScreenO 

print "Under Construction - Cart Checkout" 
msg = input("Hit Enter to Continue") 
continue 
else if selection equals "Q" 

myDisplay = input(" Goodbye! ") 
break 

else: 

call clearScreenO 

myDisplay = input( "Invalid Choice = Must be 1, 2,3 Q ") 

return 



PUTTING IT TO USE 



The intent of this section is to introduce the new programmer to standards and techniques frequently used by 
professional programmers. Topics in this section relate to concepts introduced in the chapter but with a more 
vocational or occupational focus for students considering a career in programming. 



CHAPTER REVIEW 



Chapter summary, highlights, key terms, short answer questions, quizzes and case studies to reinforce topics 
covered in this chapter. 

CHAPTER SUMMARY 

After finishing this chapter you should understand and in some cases, demonstrate the following topics: 



• Explain fundamental concepts of event driven programming environments and the connection between 
text and graphical user interfaces and event processing. 

o Event driven programming design can make programs easier to use and more conversational. 

o For some programming languages (like Visual ~Basic.Net), event driven programming are the 
design of choice. 

o A text or graphical user interface is necessary to register events for the user and provide them an 
interface to trigger/fire events. 

o Event driven programs allow the user to control the sequence of logic processing with the 
triggering or firing of events. 

• Differentiate between event driven programming and sequential processing environments. 

o Sequential driven programs execute statements one after another in a fashion similar to reading 
a book. 
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o Event driven programming logic is controlled with the execution of the events. The programmer 
designs the program so that the user can control the sequence of program step. 

o Losing absolute control of program logic execution can create additional error processing 
concerns and testing for the programmer. 

• Demonstrate the design of logic models for event driven programming applications. 

• Explain the connection between registering and handling events and the lifecycle of an event. 

o Events are first registered on a user interface (text or graphical). Once the event is selected or 
fired the listening program dispatches the event to the appropriate event handler where code 
associated with the event is processed. 

• Describe common trapped events found in text based interfaces. 

o In application that only support text interfaces, keyboard events can trip event handing, 
o Graphical interface applications use graphical controls to trip event handling. 

• Describe design and testing concepts used when developing event driven programs. 

o Event driven environments require additional testing to insure that the user can not trigger 
events in a sequence that might cause the program to error. 



CHAPTER KEY TERMS 



Command Line 
Event 

Event Driven Programming 
Full Screen Interface 
Graphical User Interfaces 
Program Events 
Sequential Processing 
Storyboard 
Test Matrix 
Text Interfaces 
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PART 4 INTRODUCTION TO OBJECT ORIENTATED PROGRAMMING 



CHAPTER 12 GRAPHICAL USER INTERFACE PROGRAMMING FUNDAMENTALS 



IN THIS CHAPTER, YOU WILL LEARN HOW TO: 



• Explain fundamental concepts of event driven programming environments tliat use grapliical controls and 
events to process logic 

• Differentiate between event driven programming via a graphical user interface and sequential processing 
environments. 

• Demonstrate the graphical user interface design fundaments. 

• Summarize the various types of graphical menus and recognize when each should be used in a program. 

• Describe and differentiate the various forms of program help and documentation. 

• Describe performance, maintenance and testing concepts used when developing event driven graphical 
programs. 



INTRODUCTION TO EVENT HANDLING WITH GRAPHICAL CONTROLS 



I might be accused of saving the best for last. I prefer to think of it as a reward for the effort you've spent learning 
the fundamentals of programming. Chapter twelve represents our last chapter of new information. In this chapter, 
we will discuss the development of programs that have a graphical user interface. Although the bulk of processing 
is still done using structured programming techniques, GUI programs represent the state of the art in program 
designed and are the programs most preferred by users. I speak of the programs that we use with Microsoft 
Windows, Apple OS 10 and Linux. We will use graphical controls (i.e. command buttons, text boxes, label boxes list 
boxes, menus, etc.), along with event driven processing techniques, to create applications which are not only 
graphical but also are real time and interactive. This chapter is a continuation of topics discussed in chapter eleven 
but this time with a graphical interface instead of a text Interface. 



Graphical User Interface - a graphical user interface allows the user to process inputs and control the program 
graphically via screen graphics along with pointing devices and the keyboard. The most well known graphical user 
interface is the Desktop that comes with Microsoft Windows but graphical interfaces are not exclusive to operating 
systems and can be designed for any program. 



Graphical Controls - Graphical controls are screen graphics that facilitate the inputting, processing and outputting 
of data. A command button graphical control signals to the program that processing must be executed; a textbox is 
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a graphical control allows the user to key data into a box draw on the window; a label box control allows the 
programmer to output text to the program window. 



Background Information: Your first programming language - If we reflect back to chapter one, one of the goals of 
this eBook and the approach it uses is to encourage new programmers to model their applications first and then 
code the applications once the models have been tested and proven out. You may find that in your first 
programming class, especially if it is Visual ~Basic.NET or Java, you will focus on developing the interface for your 
user. The Integrated Development Environment (IDE) available for developing graphical programs is sophisticated, 
graphical and almost video game like in the interactivity used to create the GUI user interface. Unfortunately, the 
problem with this type of approach to programming is that the rigor, discipline and standards found include logic 
quite often is overlooked in the speed (enthusiasm) in which the IDE allows the programmer to create a program. 
The program may not be a good program. The program may not be of high quality or very reusable but 
nonetheless a program can be created rather quickly without a lot of discipline in regards to logic and good 
program design. In some respects, this chapter has been left to the end of the eBook so that the emphasis on 
design is not lost in the impatience to create those first programs. A quality graphical program will need to take in 
consideration many of the concepts (i.e. logic modeling and program design) covered in earlier chapters. 

As the sidebar above suggests, the graphical user interface is an extremely important component of today's 
applications but rather than introducing this topic first, as it is with many programming classes, I have left it at the 
end to highlight the fact that without good logic and program designed the program is simply a multimedia slide 
show. These programs although appearing to be sophisticated are in reality of poor quality and because of this, 
little value to the user or the organization. 

This is perhaps my last opportunity to make the case for modeling and good program design. It's fundamental to 
this eBook and it is fundamental and being a successful programmer. Reflect back on one of the earliest analogies 
made regarding the rigor of programming. I said that any of us could probably build a house out of wood, cement 
and wire and glass. This house may look like a house (roof, windows, rooms and etc.) when we are complete but it 
lack the standards found in homes built by architects and professional builders. Our house is still a house just like a 
program is still a program but as I have just noted, not all houses are the same and not all programs are the same. 
To be a professional in any occupation is important to learn the standards and techniques used by professionals in 
that field. Once again we will start with modeling and moved to programming. Once again, we will stress the rigor 
and standards found in high quality, highly reliable and highly performing programs. 

Key Topic - The quality of the program (logic and design) is always more important than the multimedia or graphics 
standing in front of the logic. 

THE GRAPHICAL USER INTERFACE (GUI) 

All GUI programs must first start with the most basic graphical element. This element is the main window and acts 
like a container holding the various graphical objects necessary to control our program. Different programming 
languages have different names for this initial window. Visual Basic will call it a form and Java will call it a frame. 
What is fundamental to all these languages is that this main window is the container which allows us to build our 
graphical user interface. 
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Main Window - The main window is the start up window associated with the application. Other windows may be 
subsequently called after the program starts. The main window like all graphical windows holds graphical controls 
and provides an interface for the user. 



Form / Frame - Many languages refer to windows created with the application as Forms or Frames. Forms and 
frames, like program windows, act as containers for graphical controls. 



Programming Tip: When developing a graphical program, a main window will need to be programmed as a start 
up to the application. 




Figure 1: Screenshot Graphical Interface with Main Window 
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Related Subject: The Window Expanded - Having said that each graphical application has a main window, I must 
also make you aware of the fact that most programming languages have further specialized types of windows. For 
example, to create the desired graphical appearance, many languages will allow you to create a window within a 
window or what is also known as a panel (some languages will allow for further specialization and have a special 
control called a group box which contains a collection of radio buttons). The main window acts as a container of 
graphical elements and panels and each panel that can also act as a container of graphical controls. Beyond that, 
many languages have preconfigured special types of windows, such as dialog boxes, that may also be implemented 
by the programming language. This increased specialization of a window objects is to make life simpler for the 
programmer as they strive to create a graphical environment which is the most useful and productive for the end 
user. 

GRAPHICAL CONTROLS EXPLAINED 

As users of Microsoft Windows or the Apple OS 10 operating system, you are already familiar with many of the 
graphical controls available in GUI programs. A graphical control is a graphical image placed on a program window 
to facilitate the entry of inputs, the control of the programming and the display of output. The graphic may be as 
simple as a rectangle and as complex as a pull down list of values. 

Graphical controls are implemented as class files (see related subject sidebar article). Because they are class files, 
they contain properties, methods and events. Properties allow the programmer to set the data elements of the 
class object which determine the personality of the control. For example, when creating a command button 
control you can specify the text label on the button by setting the text property, the size of the button by setting 
the size property, and the background and foreground color of the button by setting those class properties. 

Methods are modules associated with actions the controls possess. Some controls, the text box for example, 
possess methods which facilitate activities on the control. For example, many languages have a clear method 
associated with the text box control. Since a text box holds editable data, a clear method is useful for moving all 
text in the control with a single command. A method is called in program code. 

Each control has its own specialized function but many of the GUI controls share a similar methods and properties 
but also have methods and properties which are unique. The clear method which is useful for text boxes holds 
little value for command buttons so therefore a clear method is not available with the command button class. 

Properties - Properties are class instance variables that hold data settings (or characteristics) of graphical controls. 
For example, command buttons have a property to set the label on the command button along with properties to 
set the color, fonts and size of the buttons. Each control will have its own set of properties. Refer to the 
programming reference for specific properties. 



Methods - Methods are procedures associated with class files. Methods allow for modules or blocks of logic to be 
connected to controls and when executed will provide special services for that graphical control. 



Events - Events are methods that are associated with input actions such as mouse clicks or keyboard key input. Just 
like methods and properties, each control will have its own set of events. 
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Programming Tip: Many programming languages support the same types of GUI controls. But even though all 
languages support a control like a command button, In each language implements the classes differently and so 
therefore it's advisable to locate the programmer's reference for specific information. 



Key Concept: When working with class files, the data elements of that class can be referred to by various names. 
You'll see class member data referred to as attributes, data members and properties. The most common reference 
when working with data elements of a graphical control class is class properties. 



Related Subject: Controls are Class Files with Properties and Methods - A little flash back here to an earlier chapter 
on class files. When programming languages make a standard set of graphical controls available to the 
programmer, these graphical controls are actually class files. These classes contain properties and methods just 
like the classes we had discussed in earlier chapters. The class properties hold the attributes or data elements of 
the control. For example, a command button is labeled with text to identify the function of the command button. 
This text on the button represents a property of the class file. The TextBox might contain a method which allows 
the programmer to quickly clear the text box contents. No matter the button control or the programming language 
graphic controls represent class files of reusable code. If we go back to those earlier chapters on classes, certainly 
the toolbox and its controls represents an excellent example of the benefits of code reuse. The alternative to code 
reuse would be a scenario where every programmer would have to create all of the code necessary to implement a 
command button that visually appeared in our programs application window. In addition, each would have to 
coded with it all of the properties and events necessary for it to work in this graphical event driven environment. I 
say bravo to code reuse! Why reinvent the wheel if what you need has already been created. 

Most of the languages which support graphical user interface programming also have programming IDE's that 
contain window editors. These window editors allow you to graphically positioned controls from the graphical 
controls toolbox. During design time, the programmer will have available in interface a properties window editor 
that will allow the programmer to select a control and set its properties. 
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Figure 2: Visual Studio Control Toolbox and Properties Editor Window 
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It is also possible with programming statements to accomplish the same setting of properties but instead at run 
time. This is especially important for some properties like the text property. The text property for a label box might 
be initially set as empty during design time but as the program completes its logic, that text property may be set 
via a programming statement to contain a data from a variable that was derived during program execution. 



Design time - Design time is that time in the development process when the programming is coding the program 
logic in the IDE. It is common to set the initial properties of graphical controls during design time via a Properties 
Editor Window. Properties set at design time represent the default values. 



Run Time - Run time is the time the program is executing. Properties can be set at run time die to program logic. 
For example, you might have a menu option to set the background color of the window. Your selection at run time 
can be used to change the color during program execution on the fly. 



Graphical controls are connected with various events to facilitate executing program logic. The event processing 
and event handling in a GUI program is very similar processing with a text interface described in the previous 
chapter. The difference between a text interface and a graphical interface is that with graphical interfaces the 
programming language typically identifies events commonly associated with the graphical operating system 
environments. For example, the command button, along with other graphical controls, is borrowed from class files 
included with the operating systems. What controls are available to a programming language is a function of what 
controls are supported by the operating system. 

COMMON GRAPHICAL CONTROLS IDENTIFIED 

This list below is designed to represent graphic controls commonly found in most languages that support graphical 
interface programming. The list is not extensive and also does not take in consideration third party controls which 
are developed by independent companies not associated with a programming language or operating system. 



309 



Introduction to Event Handling with Graphical Controls | http://laptoppress.garymarrer.com 



Cocyrlghlcd matenai 



Window Graphics Controls 



Sample Window 



Top Lewi Drop Down Mann Option 



Meru Sub Item 



L 



Text BoK 



Command Button 



Cfieck Box 



LIstBox Items 


d 






Grojp Bex 



Combo Box 



Enter Text 



i 



ConteKt Meru 1 
Content Manu 2 
Cortext Menu 2 



® Optort Button 




Figure 3: Graphical Controls on Main Window 

• Command button control -The command button control is designed to trigger events that execute 
functions within the program. Most programs display an OK or CANCEL the command button to continue 
or terminate a function of the program. 

• Text box control - The text box control is designed to allow the end user to enter or edit character text. 
The text box control can display single or multiple lines of information. Most of the time, the textboxes 
used for program input. 

• Label control - The label control positions text on the window. This text is not editable and is used to label 
various controls on the main window or to display logic output from the program. 

• Option button control - The option button is also known as a radio button and is presented on the 
interface as a small circle that is either filled (true) or unfilled (false). Option buttons are useful for 
designating program parameters which are mutually exclusive. For example, you would use option 
buttons to represent gender (male / female) because only one of those options could be true at one time. 
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• Check box control - The check box control is similar to the option button control except that it is not 
mutually exclusive. This means that a group of check boxes are all independent of each other and 
therefore all could be checked (true) or unchecked (false) or any combination of true and false. 

• Group box control - A group box control serves two purposes. A group box can be used to graphically 
place a box around a group of controls to isolate them on the window and show that their associated with 
one another. A group box can also be used to hold a series of option buttons. With a group box, you could 
have several sets of option buttons on a window. Without a group box only one set of option buttons 
could be used since that one set is associated with the window as its container. 

• List box control - A list box control is a rectangle that optionally contains horizontal and vertical scroll bars 
depending on the numberand size of the items stored within the list. A list box is useful when only certain 
values are valid and typing them into a text box would require additional validation. 

• Combo box control - A combo box control is a specialization of the list box. It also displays a list of items 
but has the distinction of being collapsible. Combo boxes normally take up one line of text but can be 
optionally expanded by clicking the down pointing arrow to the right of the combo box text. Combo boxes 
are popular because they take up less space on the window then a list box. 

• Dialog box control - The dialog box control allows the programmer to invoke a new window on top of the 
main window which can either collect input or display output to the user. Dialog boxes could be created 
by the programmer as new windows but are included in most programming languages as a productivity 
aid since dialog boxes typically are numerous and most graphical applications. 

• Drop down menus control - Drop down menus fall from the taskbar and allow the programmer to provide 
a menu to interface into program functions. Each menu item maps to an event that's has associated event 
handling programming statements. The menu item works much like a command button. 

• Context menus control - Context menus form the same function as a drop down menu except that rather 
than being attached to the title bar of the window they instead float within the window and are activated 
with a right button mouse click. Context menus typically have fewer menu options than pull down menus 
and like drop down menus have associated events to call event handling routines for each menu option. 

• Picture/image box control - Given the graphical nature of our interface is only natural to want to display 
pictures, graphics and images. The picture box works with images like a label box works with text. The 
picture box allows us to output images. 

Some controls missing from this list are the status bar control, the toolbar control, the tab dialog box control, the 
slider control, and the timer control. Many programming languages also file and database provide support via a 
control or component. In Visual Studio, the drop down menu control is added to a window as a component. The 
component facilitates a menu designer wizard that allows for the visual design of menus. 

Component - A component is a class file that represents some logic function connected with the application but 
may not be represented on the screen as a graphical control. Components also exist with graphical controls in the 
toolbox. Components can have their properties and methods called from the program just like graphical controls. 



Logic Tip: When writing pseudo-code for graphical programs, you will almost always have pseudo-code associated 
with processing activities which are usually performed by buttons or menu options. 
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Programming Tip: A control is said to be in focus when it is highliglited in tlie application because the user has 
navigated to that control with either the tab key or a mouse click. 

With GUI programming, graphical controls can represent the inputs, processing and output of our application. As 
with all systems, controls rely on systems theory concepts which say that programs except inputs and process that 
inputs into something which is processed and then is outputted. In a GUI program, text boxes, combo boxes and a 
list boxes act as inputs. Command buttons, toolbar icons and drop down menu buttons initiate processing while 
label boxes, text boxes, list boxes and combo boxes can act as outputs. Some controls like the command button 
have a single purpose (execution of program logic) whereas a text box or combo box might be used for input or 
output. 



Background Information: The Tool Box - Although they will look familiar, we need to as programmers now focus 
on the best to control to use each under which situation. For example, a label box control in a text box control will 
both display character information in a graphical program. However, the label box is a non-editable Control that is 
useful for displaying taxed but not changing text. A text box allows the user to changing values within it. In other 
words a text box allows and it's. If we are accepting values in two text boxes that will be added together and 
displayed to the screen, I were two text boxes would work fine for the two values to be added in a label box would 
work best for the displayed calculation. The label box is most appropriate for the display to answer since a 
calculated value is the result of inputs and therefore should not the user to believe that that calculated value can 
be edited. Conversely, a label box is a non Ana bowl in by definition cannot accept input. The label box could never 
work to accept and input into the calculation. This is one example of many issues which must be resolved in 
designing an effective interface. Throughout this chapter we will address these issues and propose guidelines for 
the appropriate use of graphical controls. 
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Status Check 

List some controls you have used in programs and identify if they are used for input, processing or output? 
What Is meant when we say out programs borrow the controls from the operating system? 
What Is the significance of the main window? 



GRAPHICAL EVENTS EXPLAINED 

The events associated with graphical controls are both specific and common across most programming languages. 
They are specific and that events usually are associated with controls that provide the processing component of 
the application (I.e. command buttons are used to execute processing). In other words, these execution controls 
will take existing inputs and process that Input would logic Into an output. Command buttons are perhaps the most 
common graphical control used for triggering or firing events. If you surveyed all of the languages that supported 
applications with graphical user Interfaces, you would find that they all probably contained something which 
appeared like a command button. The command button has an event which was triggered by clicking on the 
command button or hitting enter while that command button Is In focus. In addition, you would also find other 
events commonly associated with command buttons. Not only will a single click fire a specific event but also a 
double click or a right click on a control. A single-click is different than the double-click Is different than a right- 
click. All can have events associated with them. Every control has multiple events associated with the control or 
component. The programming reference will Identify each. Therefore, It's possible for a command button to do 
something different if It's a single clicked versus If It's double clicked. 



Related Subject: Intelll-sense - Help Is on the way! - Microsoft Corporation developed Intelll-sense for Its Visual 
Studio IDE but It has been cloned by many IDE's. Intelli-sense Is a wonderful tool for programming controls and 
components. As soon as the control name has been specified and terminated with a dot to Identify the class 
member, a box of valid class members (properties, methods, events) Is displayed. You can select with the mouse 
the member you want to program. This save a lot of time and keeps you from spending a lot of time In the 
programming language reference documentation. 
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Single and Double Click: One of the common event triggers is the click event. For most controls there is both a 
single and double click event. A signal click is a single click of the left mouse button and a double click event is two 
quick clicks of the left mouse button. 

It is important to remember there are more controls than just command buttons. You'll find that reading the 
programming language documentation will produce a wealth of documentation on each controls properties, 
methods and events. 

Below I have listed a table of events available for a list box, the label box and a command button in the Visual 
~Basic.NET environment. Some events will be similar and some unique to the control. 

Note: the table below represents a partial list of command button events 

Command Button 

Click Event- control clicked event fired when left mouse button is clicked over button 



Drag Drop Event - Event is fired when control dragged with left mouse and dropped on another control 



MouseHover Event - Mouse cursor overtop of control 



Resize Event- Control is fired with control is resized with mouse 




Figure 6: Screen Shot of Drop Down list of Command Button Events 
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GRAPHICAL EVENTS VERSUS TRADITIONAL PROGRAMMING LOGIC 



The most significant difference between graphical user interface programming and traditional programming is the 
addition of the graphical user interface. Whereas with traditional programs we typically have created are logic 
model and then translated the module logic into programming statements, graphical user interface programming 
contains an additional step. Just as in the previous chapter we needed to create a text interface to allow the user 
to control our program, a graphical user interface also has to be created for a program written to run graphically. 
This requires us to first model are graphical interface via storyboards and then using those storyboards create with 
graphical editors the screens with controls added and properties set. IVIost programming languages that support 
graphical programming also contain a sophisticated IDE are to add edit and delete graphical controls from the 
program window (previous slides in this chapter have highlighted the Microsoft Visual Studio). 

PROGRAMMING A GUI APPLICATION 

I will use a discussion of Visual Studio.NET and PYTHON to demonstrate how a graphical program is created. I will 
use many of the concepts discussed in earlier chapters to build and implement a graphical application. 

GUI PROGRAMMING IDE'S 

Fundamental to programming applications with a graphical user interface is a robust IDE. Graphical interface IDE's 
contain the ability for the programmer to graphically design the main window with graphical controls along with 
the ability to connect event code, when appropriate, to those controls. What this means is that from one IDE 
window the programmer has the ability to drag and drop controls from a toolbox and from that graphical 
environment manipulate those properties which pertained to the visual properties of that control. At the click of a 
button, the programmer can activate events associated with those controls and include the event handling code 
necessary to associate the graphical control to some logic function. 

USING AN IDE FOR A GUI PROGRAM - THE PROCESS 

A popular IDE used for programming graphical applications with Visual Basic is the Microsoft Visual ~Studio IDE. 
Other languages may have different IDE's is but they all fundamentally work in the same ways. Below I have 
isolated the steps used in creating a Visual ~Basic.NET application using the Visual ~Studio IDE. 

• A programmer using a product like Microsoft's Visual Studio will first create a project containing all the 
files needed to implement the program. The IDE will automatically create all of the initial files required to 
start the project. This includes creating a main window for the programmer to add a graphical controls 
and event handling code. 

• Using the logic models and storyboards created before programming, the programmer implements the 
storyboard drawing with the visual designer available with the IDE. This means dragging graphical controls 
from the Visual Studio toolbox to the main window (called a form in Visual Basic). 

• Once the control has been dragged to the main window, the programmer can use the mouse to resize and 
position the graphical control on the main window. At this time, the programmer may also choose to set 
any design time properties associated with that control. For example, a command button will need to 
have the button label text set so the programmer will use the design time property editor to specify the 
text displayed on the button. 

• Once the main window has been created, the programmer must now add the program code to the 
associated events defined within that program. This means that pseudo-code created as part of program 
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logic planning needs to be transferred to graphical objects which initiate execution. For most graphical 
user programs, this would include command buttons, drop down menus and toolbars. For the Visual 
Studio IDE, this would require entering into a programming code window which would leave the graphical 
environment for a text editor that would facilitate the creation and editing of programming statements in 
each event handling procedure. 

• In Visual ~Basic.NET, events are implemented through procedures (or modules) that are assigned to 
assigned event handlers. 

The Visual ~Studio.NET IDE provides an environment for the programmer that allows them build their user 
interface and event handlers, create their programs statements, compile those statements into an executable 
program and finally provide a runtime environment for testing. 



SETTING VALUES OF CONTROL PROPERTIES OR PROGRAMMING THE CONTROLS. 



As has been mentioned already in this chapter, programming the values of graphical controls the very important 
aspect in designing the application. Changing the data attributes of control classes can be a very important aspect 
of program control. For example, changing the visible property to false for a command button would remove that 
functionality from the program. Manipulating control attributes both during the design of the interface and as the 
program is running amounts to programming the controls. This important feature allows the programmer to 
develop an interface which is at all times usable and consistent with the underlying logic. In the last chapter, I 
discussed a scenario where steps of a program or implemented as selection items on the screen. Command button 
one contained programming tasks which needed to happen before the tasks associated with command button two 
and command button two had tasks that need be completed before them and buttons three could be made 
available. By programming the properties of each of the controls, I can use control properties in concert with 
program logic to ensure that the program remains stable and accurate for the user. 

The setting or programming of these properties can be accomplished at design time via property editors or a 
runtime via programming statements. If you refer back to our chapter on classes, you'll remember that the 
variables of the class are identified with the class object in with that allow the programmer to assign values to 
those class properties. For example, the code below would allow the programmer to change color of the label box 
to read because of the outcome of a decision logic branch. This example is demonstrated in pseudo-code. 

myLabel as Label 
totalSales = -1 

if totalSales is less than 0 then 

myLabel. forecolor = "red" 

This example is only a piece of a larger program but as you can see from the pseudo-code, a label control called 
myLabel has been created. A variable holding totalSales has been initialized with a value of -1. The if statement 
uses as its Boolean expression a comparison between totalSales and zero. If the value in totalSales is less than 
zero, the foreground color property of the myLabel control is changed to the color red. This is all done at run time 
as the result of programming logic. The design time value of the foreground color of myLabel was set with the 
default of the color black. The label text would remain black unless it was changed at run time as the result of 
some programming logic. 

PSEUDO CODE LOGIC AND STORY BOARD MODEL OF GUI PYTHON PROGRAMMING 
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The pseudo code used in this model is not unlil<e the pseudo-code use of in other chapters. The logic for this 
particular program is fairly straightforward as a result the pseudo-code is also brief. 



start 

frame as Frame 
numberOne as textbox = 0 
numberTwo as textbox = 0 
calc as button = "Calculate" 
answer as label = "Answer = 0" 
loop equals True 

event on calc call addNumbers 
while loop 

end 

addNumbersO 
try 

valuel = numberOne. text 

value2 = numberTwo. text 

total = valuel plus value2 
answer.text = "Answer = " plus total 
catch 
print "Input Error" 
return 

STORY BOARD 

Storyboards can be created with paper and pencil or can be created using graphics software. In the Microsoft 
windows environment, the peak program which comes as a free utility with windows is one tool available for the 
programmer to create more professional looking storyboards. A more powerful graphics will tool is Microsoft Visio. 
The figure below contains the story board for this application created with Visio. 
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Figure 7: Application Graphical Interface Story Board 



GRAPHICAL MENUS 

Menus not only provide a valuable resource when ordering dinner at restaurants but also have become a critical 
resource for software developers to create programs that are easy to use. As a user of a graphically rich operating 
system like Microsoft Windows, it doesn't take long to learn that the rectangle located at the top of the window 
with words spaced across it is actually in an electronic menu. From these drop down menus, a user can click and 
get a sub list of features related to the top level menu name. For example, most drop down menus adopt the 
Microsoft standard of having File in the first menu position and having help or about it last menu position. We 
know that if we click on the File menu option a list will appear below it some of the menu options found under it is 
Open, Save, Save As and Exit. Other menu options may be different and specific to the application. As a user of 
graphical interface applications, we can count on the menus to behave the same and have similar menu options. 
This provides for tremendous options in regards to software usability (a topic will discuss later in the chapter). 
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Drop down menus: Drop down menus are traditionally found at the top of the window and appear as a series of 
labels across a menu bar. As the label is selected with a mouse click, a series of menu items appear each of which 
can be clicked to execute code defined by the label. 



In addition to pull down menus, many program languages have implemented context menus. A context menu is a 
special floating menu that appears somewhere inside the main window and usually activates when the right 
mouse button has been clicked. The context menu typically contains a subset of menus targeted specifically to 
work with the theme of the application window. For example, a right mouse button click over a multi line textbox 
might produce a menu that has options of copy, cut and paste. All functions typically associated with the editing of 
text. 



Context menu - Context menus appear as floating menus over the application window. Context menus are 
activated by a right button click on the mouse and are typically have menus typically associated with the functions 
defined on the application window. 



DROP DOWN MENUS 

Most programming languages that support drop down menus support two techniques for creating the menu 
options and tying those options to events. In all programming languages, the drop down menu and its options can 
be defined with program code. Sometimes, the programming language IDE will also contain menu designer tools 
that allow the programmer to develop their menu and menu options with a graphical tool. Even though the tool 
appears to be taking control over menu creation, it is actually behind the scenes creating statements that the 
programmer could have alternatively created on their own. Menu designers can be thought of as a productivity aid 
the take the tedious task of menu definition and set up and reduce it to a few mouse clicks and a few keystrokes. 



Menu designer- a menu designer is a graphical tool integrated into the IDE that allows programmers to graphically 
designed drop down and context menus. For those IDE that do not support menu designers, menus are created 
using programming statements. 



Menu options, like command buttons, each have to be associated with an event handler that will perform the task 
designated by the menu option. For example, clicking on the exit option under the file menu should call 
programming code which will terminate the application. Menu designer software requires the programmer to 
create the event handling code after the design of the menu itself. 

CONTEXT MENUS 

Drop down menus and context menus are still just graphical controls. They're more sophisticated than your typical 
command button or textbox but they both programmed the same as you would a command button. For those 
programming languages with menu designers, there is one control for the drop down menu and a second control 
for the context menu. The menu designer implements each in a similar fashion. The designer creates the context 
menu but the program needs to create the event handler code module. 

GRAPHICAL USER INTERFACE DESIGN FUNDAMENTALS 

Most users of computer programs will tell you that programs that have a graphical user interface are easier to use 
and more intuitive for the average user. This is only true because most of these programs have been developed to 
similar design standards. For example, what if in my drop down menu I decided not to put the exit option under 
file but instead put it under the top level menu option of about. Since this is not the standard location for finding 
exit, the user most likely would become confused and spent a great deal of time and frustration searching out for 
this important action. 
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Another less dramatic but still importance standard that most programs follow is the designation of a tab order. 
The tab order is set up to follow the natural progression from control to control across the window. If we were 
filling out a mailing label for example, we would want the cursor to start in the name textbox and when the tab key 
was struck we would intuitively move to the next text box where we needed to type our street. If the tab order is 
not set in the correct sequence so that we are randomly jumping across all the controls on the window, this will 
certainly confuse the user and potentially frustrate them enough so that they will not use our program. 



Tab order - level window constitutes the sequence in which the tab key moves across controls contained within 
that window. The tab order should reflect the natural progression of using that application. 



USABILITY CONCERNS 

Usability addresses the ease in which your program is used by someone else. When someone starts your 
application will they be able to use it without extensive training and research. Will they be able to execute the 
basic functions of the program along with understanding how to navigate through the program based on their 
previous experience with graphical user applications? For example, will the exit button be waiting for them 
underneath the drop down menu option labeled file? Will the program look like other graphical programs? Is the 
program intuitive to use? 



Usability - Usability refers to the relative ease in which the user operates your program. Greater emphasis on 
usability improves the effectiveness and efficiency of the program by making it easier for the user to operate the 
graphical interface and the underlying program logic. 



Although the definition for usability seems to be understood by everyone it is probably best to define it in terms of 
the operating system you're creating your application for. Although the graphical user interfaces for Microsoft 
Windows, Apple Macintosh OS 10 and Linux are similar, they are also different. Most of my programming classes 
are developing applications for the Microsoft Windows programming environment. I have yet to find detailed 
design guidelines or usability recommendations for applications running under Microsoft Windows. Although 
nothing has been formally written, all applications seem to take on the appearance of the applications developed 
by Microsoft. For example, I tell my students that in regards to Windows graphical design guidelines; they should 
refer to Microsoft Word or Microsoft Excel to get hints and tips as to how to design an Intuitive graphical interface. 
Usability In this context is more like impersonation. We want our applications to have drop down menus and 
toolbars at the top of the screen, command buttons that include shortcut keys and tab stops that flow through the 
natural progression of the application. Beyond impersonation and these simple rules, the responsibility is on the 
programmer to ensure that their application is intuitive and easy to use. Certainly if an application takes on a more 
creative and varied approach from existing standards, additional testing will be necessary to ensure that the user 
knows how to operate the program. 

USABILITY FOR DISABLED USERS 

If one is developing applications that will be used by a wide number of users, there is a high likelihood that some of 
those users will have some form of a disability. The user may have a sight disability or the user may have a 
disability that restricts their use of a mouse or keyboard. A user might be colorblind and therefore only be able to 
see certain colors placed in a graphical interface. All of these are legitimate concerns for the applications 
programmer. As the programmer, you should become familiar with what the operating systems offer as 
alternatives to the standard monitor, the keyboard in the mouse. For example, many operating systems allow the 
screen to be magnified so that persons with sight disabilities will be able to view the screen with larger letters and 
graphics. Most programming languages allow for the inclusion of shortcut keys. If a person has a disability which 
limits their hand movements, then use of the mouse may not be a possibility. The program will need to have a 
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shortcut keys (i.e. alt-x to Exit) so tliat the user with limited hand movements can place their fingers over the 
keyboard and simulate mouse clicks with keyboard keystrokes. 



Certain color combinations allow color blind users to view all of the colors on a computer screen. Many companies 
have done extensive research in this area and a little research into your operating system will probably identify a 
color scheme that is the easiest color selection for color blind users. 

This is only a partial list of some of the considerations that must be made to handle those users with disabilities. 
Certainly our ability to build these accommodations in the design of your program will speak very positively to your 
abilities as a professional programmer. 



Shortcut keys- Shortcut keys for programs written for graphical user interfaces are typically a combination of a 
specialized key (i.e. the alt or control key) coupled with one of the characters from the keyboard. For example, the 
alt-x key combination might be established as a quick key method to end the application. Note: Many shortcut 
keys are set with the operation system and any program use of short cut keys should be consistent with these OS 
short keys as to no cause confusion (i.e. control-c is the Windows Copt shortcut so control-c should not be refined 
in your program. 



USABILITY FOR INTERNATIONAL USERS 

If any one does not realize that computers exist around the world, let me point out that business and computers 
are international. Writing successful software that is suited for widespread use means that the program might 
need the ability to display text on graphical controls in a variety of languages. Again, this has not been lost by the 
developers of programming languages and operating systems. A little research on internationalization will yield a 
wealth of material to assist you in making your software truly international in available to users communicating 
different languages. 

Internationalization -Internationalization describes the support many programming languages have for application 
development for different languages. In addition, internationalization accommodates currencies different than the 
United States (i.e. pounds for Britain and the Euro for the European common market). 

APPLICATION PERSONALIZATION AND CONFIGURATION 

It has been said that "variety is the spice of life" and it is also true in application programs. Given the wide 
flexibility for multimedia controls and components available to the application programmer, your users will want 
to take advantage of what they have already seen in other applications. By this, I mean you will want to create an 
environment where the user can customize the applications color, sound or other multimedia effects available 
with that programming language. Although user customization may not be the primary objective of the problem 
you are solving, it will help in the acceptance of your program and promote its use. Allowing the user to set colors 
and a turn on or off sound is a minimum level of configuration available with most software today. Trends indicate 
that software will look more like video games in the future. These environments will need to support even more 
configuration and multimedia with the availability of different application graphical interface skins collections of 
color in graphics to personalize the graphical interface. This is a topic outside the scope of this eBook but one 
which has been heavily researched and written on via web sites on the Internet. 



User Customization - user customization describes features within your program to allow the end user to change 
colors, fonts or program characteristics. 
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Skins - Skins is the name given to classifications of color scliennes and graphics they can be set for your application. 
For example, a metallic skin might give window graphical features the appearance of metal and adopt color 
schemes of gray black and blue. Skins allow the user to customize their application experience to their own 
preferences. 



Status Check 

Screen controls are classes with data and properties. How does the data set the personality of the control? 
What are the differences between a pull down menu and contest menu? 
What is usability and how is it supported in your graphical applications? 



THE PROGRAMMING PROCESS WITH GRAPHICAL USER INTERFACE PROGRAMS 



Fundamentally, the process that we have described throughout the eBook of defining the problem, performing 
fact finding, developing a conceptual design, creating a physical design, programming and testing remains the 
same with graphical user interface programs as it has done with traditional sequential applications. As explained in 
the previous chapter, an additional step necessary in the process when a application has been designed around the 
handling of events is the development of a story board. With our text interface, the storyboard was fairly simple 
and straightforward with the outlining a text on a screen. With graphical interface applications, the creation of the 
storyboard is a much more involved process due to the variability and flexibility the programmer has with 
numerous graphical controls. Creating a story board, even if it's handwritten on a piece of paper, provides needed 
validation from the user. Analyzing a story board with the users for effective interface design is very similar to what 
advertising and marketing professionals do when proposing a new product. The story board session acts like a 
focus group session. A variety of input can be solicited and incorporated in the program design. 



Related Subject - Are Programmers Good Screen Designers - As a programmer, I'm had the opportunity to work on 
many web sites that relate to my programming work with the classes that I teach. As an Internet user, I have 
visited sites with phenomenal multimedia like presentation. I've also spent many a night trying to make my sites 
have that same level of professional design. I've come to the conclusion that there is not a direct relationship 
between a programmer's ability to code and a programmer's ability to design. For me personally, my websites look 
fairly two dimensional, somewhat primitive and a little unprofessional. I have come to respect the tools and 
expertise of professional designers. Individuals who have trained in art classes on the correct use of color schemes, 
canvas balance and visual optimization can be a tremendous resource to improve the usability and effectiveness of 
graphical interfaces. As has been outlined in previous chapters, as a programmer you're not an island but person 
who has to work with many others to get the job done. Just like you'll need to work with database administrators 
when developing database applications, you'll also need to work with designers are working with graphical 
application interfaces. Sometimes not good for the ego but always good for the application a programmer must 
realize that it is unusual to be good at everything and more probable that you will be good at one are two things 
associated with the system you're developing. 



TESTING PROCESSES 



The testing of processes with graphical user interfaces is more extensive than with programs that do not have a 
user interface. The programmer has complete control with traditional sequential applications; the programmer has 
less control with event driven applications. Applications will need to be tested to ensure that the user correctly 
understands the interface and provides a valid input sequence that is acceptable to the application. Because of the 
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complexity involved with the testing, a test matrix is advisable. The matrix can isolate a series of tests cases so that 
appropriate coverage of programming testing can be performed. Test matrix can also act as a helpful tool for 
regression testing when the application changes and has to be tested again in certified that it still remains but free 
and of high quality 

Large organizations may also perform usability testing on the application. This would bring typical users in to 
experiment and provide feedback on the application and how we could be made more effective. These usability 
tests should occur early enough in the applications development so that to minimize program rework but also late 
enough in the application development so that any final in consisted is or problems can be removed before the 
program is delivered to the end user. 



MAINTENANCE GUIDELINES 

The maintenance of event driven software, and specifically graphical interface programs, requires the same 
standards and rigors as with all programs. The program should always start with a good logic model and the 
programmer who created the application should use standards well known for that programming language. 
Identifiers should be created with descriptive names and any naming standards common to that programming 
language should be incorporated in the naming. Liberal use of comments within the programs body is advisable. I 
would encourage the programmer to comment any decision structure, all program modules, any calculations and 
any logic within the program that might represent an unusual way of dealing with programs steps. If possible, 
adopting common programming patterns will make future maintenance, either by the original programmer or by 
other programmers, the easier. The formatting of the text should be easy to read with ample white space to 
separate blocks of program logic. 

PERFORMANCE CONCERNS 

Even with all of the power and flexibility available with event driven processing and graphical controls, it can be 
easy to go beyond what is required in the program to a point where the interface becomes the focus of the 
programming. This means that the problem the program is solving becomes lost as a programmer tries to 
manipulate the graphical controls in place more emphasis on the interface and less emphasis on the problem that 
solves. 

Let me give you an example. An application that was being developed for the processing of insurance claim data 
had several codes that were critical to the processing of an insurance claim. With the ability to place combo boxes 
on the window, a design decision was made that whenever a code needed to be inputted a combo box would be 
populated from a database table with those codes valid for that item. In theory, the feeling was that this type of 
customized control would help new employees and also reduce claim processing errors. In theory a good idea in 
practice a bad one. Because of the processing overhead required for the database to retrieve and populate each 
combo box with correct codes, a query of a customer claim went from 40 seconds to four minutes. Four minutes 
was not acceptable for wither online real lime customer support or the batch entry of claim payments. The combo 
boxes were removed and replaced with a text box that simply validated the code within the program. What 
seemed to be a very productive solution that took advantage of the tools available with a graphical interface 
became in fact something that didn't help the problem but in fact made the problem worse. 

This is only one example of some of the problems they can occur with event driven graphical interface 
programming applications. As the programmer, you must be conscious of your programs performance. Testing the 
application on your workstation without heavy network load or other users connecting to the same resources can 
create an artificial sense of program performance. As part of your testing, you must make sure that you give the 
program a test when there is typical processing load on the system. This may be a difficult or impossible task but if 
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a test can be arranged where several people are using the application in a fashion similar to the way it will be 
implemented then the more confident you can be at the application will perform well for its customers. 



GRAPHICAL INTERFACES FOR INTERNET APPLICATIONS 



For most of this eBook, our discussion has been primarily for programs developed to run in a traditional 
workstation setting. This means the program is developed to run on a desktop or centralized computer (i.e. 
mainframe and mini computers). I have referred to Internet applications in our case studies but we have not 
focused specifically on it in discussions when discussing topics of structures, files, classes and I then driven 
processing. It is now important to bring this topic forward since the Internet presents a wealth of multimedia 
support that is expected by the user when running applications over the net. 

Applications developed for the Internet rely heavily on event driven processing. Internet applications are a client / 
server application which is to say a part of the application (the client) exists on the desktop and is run through the 
browser and the other part of the application exists remotely on an Internet Server. This format requires the logic 
be spread across the two computers but the logic is fundamentally the same as we have been using throughout 
the eBook. It is just split across two computers. 

From the interface standpoint, Internet applications are always event driven and make extensive use of graphical 
controls. With many programming languages. Visual Studio.NET and Java specifically, the transition from graphical 
interface running on the desktop to graphical interface running on the Internet requires minimal rework. IDE is 
used for Internet program development operate much the same. The controls used on the two environments look 
much the same graphically but do have some fundamental differences with properties and methods. Internet 
applications are a stateless application which is to say that because of two computers are involved in completing 
the program, whenever the user submits information of the server, it leaves his desktop goes to the server. At the 
same time, data stored in variables are removed from their local desktop program (thus a stateless environment). 
Special accommodations need to be made with variables so that when an application submit button is clicked that 
variable information is saved in not lost while the server pickets a pates and it's part of the program. 

Client / Server applications- Client server applications are programs developed to run partly on the user's desktop 
and partly on a network connected server. Neither application by them self completes all the program function but 
when used together via application becomes complete. When the application has been written for the Internet, 
you'll have an Internet client using a browser communicating to and Internet server each providing part of the 
applications logic. 



GUI USER DOCUMENTATION AND ON-LINE HELP 

Periodically we have addressed user documentation within this eBook. Up to this point user documentation takes 
the form of program manuals that are produced for the user to be used alongside the execution of the program. 
These manuals typically have a function of operational reference. The user's guide acts like a mini textbook and 
instructing the user how to perform activities with software. The reference acts like a "how to" to the features 
found in textbook usually organized by subject in a table of contents. 



User documentation - user documentation is created to instruct the end user on the operational characteristics of 
the program 
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Program Manuals - program , manuals are a form of user documentation which typically provides a reference to 
specific program functions. 



User guide - The user guide is user documentation that trains step by step how to effectively use the application. 



On other documentation option available to the programmer is online help. Most applications developed for the 
windows environment include as one of the menu drop downs and option for program help. Program help comes 
in many forms and can be similar to the printed manuals found with more traditional documentation. Because the 
help files are online the additional capability of keyword searches can be very useful for the user to look up 
information on specific questions or features found within the software. Some companies like Microsoft provide 
help compilers which assists a programmer in developing the standardized help environment similar to the helped 
found another Microsoft Windows programs. A cottage industry has also developed with third party vendors 
providing ways to quickly format online searchable help files from a variety of sources (i.e. MS-Word, Text files, 
etc.). 

Some languages such as Java have provided the programmer with special syntax dedicated to creating user 
documentation. With Java, the tool is called JAVADOC. JAVADOC allows the programmer to insert special 
comments within the program code so that documentation which is typically left to the end of the process can be 
included as part of the initial coding. Once the program is complete, the JAVADOC program scans the source code 
for the special documentation tags and creates an HTML file formatted for user help. 

Writing effective program documentation is an art into itself. Many times just like a professional graphics designer 
can help with the creation of an effective graphical interface, a technical writer can greatly improve the readability 
effectiveness of user documentation. Many companies have technical writers on staff to assist the programmer 
and creating documentation. Products which are being developed for resale to a wide range of customers would 
benefit from documentation created by a technical writer. Ultimately, the programmer must be responsible for all 
documentation but understanding that everyone has different strengths, sometimes outside specialized help can 
greatly benefit the project. 



Online help - Online help is when user documentation is prepared for electronic viewing within the application. 
Online help can usually be accessed like a table of contents or scanned via a keyword search. 



Third party vendors - third party vendors are software development companies that design software that extends 
functions and features normally found within the programming language. For example, in Visual Basic, before 
Microsoft made the tab dialog box available that toolbox, that control is available via third party vendor who 
designed the control to work with the Microsoft Visual Studio IDE. 



Status Check 

How is creating GUI interfaces for the Internet different/same as desktop applications? 

Can event driven design applications have performance problems where program execution is too slow? 

What issues might you address for designing applications for international users and users with a disability? 
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CACTUS CASE STUDY 



The time has come to take logic created for the purchasing of books from Cactus Books and Tapes and create a 
graphical user interface version of this program. The program initially was used to demonstrate run time exception 
processing but also contains calculations and array processing. I have simplified the processing requirements 
somewhat by only concentrating on returning to the graphical interface the cost of the item code inputted into the 
interface. Error handling is still present. As with other case studies, we start our project by updating our pseudo 
code so that our logic is modeling before It is set to program code. 

Original pseudo code with updates for GUI Interface 



wholeSaleCostO 

searchVar = 0 
foundValue = 0 

itemCodeArray["1001", "09921", "23", "13123", "5544"] 

itemCostArray[23.50, 4.90, 15.25, .90, 4.90] 

Input itemCode 

for searchVar = 0 to 5 

if itemCodeArray[searchVar] = itemCode then 

foundValue equals itemCostArray[searchVar] 
return foundValue 

return 

For the screen design, I have specifically kept the design of this applications simple. The interface is very similar to 
our CalculatorProgram and uses many of the same controls. PYTHON supports many of the controls that are found 
in graphical applications and just because I have restricted the examples two command buttons, textboxes and 
labels does not mean that that is all PYTHON has to offer. 



Case Study Story Board 




Figure 9: Story Board of GUI screen 
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Case Study Solution 




Figure 10: Screen shot of Solution 



PUTTING IT TO USE 



The intent of this section Is to introduce the new programmer to standards and techniques frequently used by 
professional programmers. Topics In this section relate to concepts introduced in the chapter but with a more 
vocational or occupational focus for students considering a career in programming. 

ADDITIONAL TOPIC: SURVEY OF HOW DIFFERENT PROGRAMMING LANGUAGES SUPPORT 
PROGRAMMING WITH GRAPHICAL INTERFACES 



VISUAL STUDIO 



Visual Studlo.NET was developed by Microsoft Corporation as an interface that would support C++, C# and Visual 
Basic with the idea that one Interface for all three programming languages would be a productivity enhancement 
for the programmer who had to move from one language to another. At the same time, the .Net framework was 
created so that class objects were also standardized across to all of the programming products. This means the 
command buttons class objects that are used in Visual Basic are the same command buttons that are used with C#. 

Visual Studio.NET is the IDE used by programmers developing applications to run on the Microsoft Windows 
operating system. As mentioned earlier, the Visual Studio IDE includes a Visual Designer which allows the 
programmer to create the graphical interface for both desktop applications and Internet applications. The IDE also 
contains a code window which allows event handlers another program code to be entered in and compiled. The 
Visual Studio IDE can also be used to execute programs to help isolate runtime errors and also test to ensure that 
the program behaves consistently and in a way which is intuitive to the user. Visual Studio also contains extensive 
help and documentation so that they programmer can reference not only programming language keywords but 
also class files which are included in the .Net Framework library. 

The Visual Studio IDE has long been considered one of the benchmarks for integrated development programming 
environments. It's a major product which has undergone various improvements over the last ten years. It 
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represents an environment which is flexible and one which promotes code reuse and the development of reusable 
components. 



JAVA 

What tends to be successful In one programming environment is quicl<ly carried over into others. The Visual Studio 
product from IVIicrosoft is a mature IDE. It been perfected over many years. As much as loyal Java programmers 
would protest, in many respects Java lags the Microsoft products in regards to productivity tools that assist the 
programmer in creating the graphical interface. This is changing fairly quickly and many products like Borland's 
Visual JBuilder, Sun IVIicrosystems's NetBeans and the Community edition of Eclipse have implement add-ons and 
features which all help the programmer to design the graphical interface, code events, and compile and test the 
application. However, many of the Java textbooks still focus on code based solutions to create of the graphical 
interface and do not take advantage of graphical window designers. 



PYTHON 

There are many similarities between PYTHON and Java. The examples created in this chapter were all developed 
with a text editor and then compiled to verify the graphical interface was developed correctly and the events 
responded as programmed. For example, in the case study solution for chapter twelve, the graphical interface is 
somewhat primitive. Part of this was to create an application that was easy to follow and partly because the tool 
used lacked the visual interface to create the GUI. The interface was created from a series of program statements. 



Additional Topic: Packaging and Deployment of Your Program - With applications that contain graphical interfaces, 
comes the possibility that your programming solution will be contained in many files. Your application may require 
packaging and deployment of the solution. The packaging process ensures that all files needed to execute the 
program are included in the program deliverable. Many IDE's contain packaging software that ensures that all 
dependent files are included in packaging. The packaging process for the programmer is specifying how the files 
are to be delivered to the end user. Packaging considerations might be if the program executable files are going to 
be compressed into a zip format or if the files are to be delivered over the Internet. Deployment considerations are 
also in play at this time since deployment is the process of installing the software on the user's computer. 
Deployment typically involves a setup file that installs uncompressed package files along with dialog boxes that 
assist the user with installation and configuration of the program. Many IDE's have packaging and deployment 
support built in. There are still other more robust solutions available with third party vendors. 



Packaging - Packaging is the process used to collect the files for the program and combine them for distribution to 
other personal computers. The packaging process would define which files would be sent for installation and if a 
configuration script needs to be completed by the user. 



Deployment - deployment describes which distribution format is to be selected for installation on a user 
computers. 



The installation of your package program on the user's PC is called deployment. You'll need to analyze your 
program to determine what information is necessary as part of programs setup and configuration on the user's 
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personal computer. You may also decide where the product will need to be installed along with configuration to 
have the program appear in the programs list or as an icon on the desktop. 



CHAPTER REVIEW 



Chapter summary, highlights, key terms, short answer questions, quizzes and case studies to reinforce topics 
covered in this chapter. 

CHAPTER SUMMARY 

After finishing this chapter you should understand and in some cases, demonstrate the following topics: 

• Explain fundamental concepts of event driven programming environments that use graphical controls and 
events to process logic 

o Graphical programming environments use windows and graphical controls that allow the end 
user to determine the sequence of logic execution. 

o Application windows act as containers for graphical controls and programmable components. 

o Graphical controls and components are reusable class files delivered with a programming 
language. 

o Graphical controls utilize events to signal their activation which is linked by programmer to 
specific event handlers. Event handlers are implemented in programming code as 
procedures/modules/methods. 

• Differentiate between event driven programming via a graphical user interface and sequential processing 
environments. 

o A program that utilizes a graphical user interface presents graphical controls on a window that 
allows the end user to select the sequence logic via their interaction with graphical controls and 
their corresponding events and event handlers. 

• Demonstrate the graphical user interface design fundaments. 

o The most important design element of a graphical interface is to provide a window which is 
familiar to the user. If placement and use of the control is standardized the operating system, 
then the interface will be both intuitive and very usable. 

o Usability is how programmers refer to the ease of use the end user experiences executing the 
programs graphical interface. 

• Summarize the various types of graphical menus and recognize when each should be used in a program. 

o Drop down menus fall from the top of the application window and provide a familiar and easy to 
use interface for launching program logic. 

o Context menus popup floating above the application window with menu options specific to the 
current task. For example, a popup menu with options to copy cut and paste may be associated 
with an editing window or the user would need those editing functions. 
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• Describe and differentiate the various forms of program help and documentation. 



o It is important to be thinking about user documentation throughout the program development 
process. User documentation can be delivered via the program annual, the user guide or online 
help. 

o Online help can be a valuable resource In a graphical program by providing real time computer 
based documentation that can be searched by the user to address problems up a rating the 
program. 

• Describe performance, maintenance and testing concepts used when developing event driven graphical 
programs. 

o The performance of graphical programs presents special considerations not found In traditional 
programs. Steps should be taken to simulate the program's execution under realistic conditions 
with system load and end users working with the program. 

o Program maintenance concerns are similar to traditional programming but naming conventions 
and programming patterns In graphical programming Is different than traditional programming 
and should be observed by the programmer. 

o Testing of a graphical program must Include testing all of the operational possibilities available to 
the user interface. It Is critical that the program still function no matter what event is fired and in 
what order. A text matrix Is one way for ensuring that coverage of all tests possibilities is 
documented and available for later retest when changes are made. If 



CHAPTER KEY TERMS 
Client 

Client / server applications 

Component 

Context menus 

Design time 

Drop down menus 

Graphical controls 

Graphical user Interface 

Internationalization 

Internet Server 

Main window 

Menu designer 

Online help 
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Program manuals 

Properties, methods and events 

Run time 

Single / Double click 

Tab order 

Third party vendors 

Usability 

User customization 
User documentation 
Users guide 
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PART 5 APPLICATION DEVELOPMENT 



CHAPTER 13 PROJECT START TO FINISH 



IN THIS CHAPTER, YOU WILL LEARN HOW TO: 

• Explain and implement program maintenance using the program development lifecycle 

• Differentiate between creating a new program and maintaining an existing program. 

• Explain and demonstrate the modularization of program code to promote code reusability and simplified 
program maintenance. 

• Describe and differentiate various program design approaches (traditional structured, object oriented and 
graphical event driven). 

• Describe implementation alternatives for new and updated programs 

• Distinguish and differentiate between traditional desk top and Internet application development. 

• Describe and differentiate various program design approaches (traditional structured 
, object oriented and graphical event driven). 

• Summarize and implement key logic design and program code concepts presented in this eBook. 



THE PROGRAMMER DEFINED 



This final chapter will act as a capstone for all the preceded it. In the previous twelve chapters, we have covered a 
variety of topics related to writing programs. In each chapter, we incrementally took a concept and broke it down 
into bite size pieces for the new programmer. It is now time to take those pieces and put them together and begin 
to think like a programmer by performing a task done by most novice programmers. The approach that we will 
take in this final chapter is not to design a project from scratch but instead to take an existing program and modify 
it. We will focus on a project that requires program maintenance. 



Program Maintenance - Program maintenance refers to programming code changes made to existing programs. 
Long after a new program is designed it is modified, repaired and improved upon. Because programming is a labor 
intensive activity, most companies will try to preserve their investment in software by extending the life of a 
program through program maintenance. 



There is a good reason why we will start this chapter by maintaining an existing program. The best reason is that 
most new programmers are assigned maintenance programming tasks before they have the opportunity to design 
new systems. 
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Since new programmers are still learning the tools of the trade and I've yet to fully understand and experience the 
tools of their craft, working with an existing application is a good place to train the new programmer. By seeing 
another programmer's work, the new programmer gets the added benefit of having a template to follow. They will 
be able to see logic patterns already implemented in code. This will strengthen the new programmer's knowledge 
of programming, debugging skills, recognition of programming patterns along with providing the programmer the 
confidence to take on more complicated programming projects. 

Like any good apprenticeship, time spent under the tutelage of a master makes the apprentice's education that 
more complete. Looking at it another way, by assigning the new programmer maintenance projects, the 
programmer only has to concentrate on parts of the entire program. Taking on only a small part of the program 
will make it easier for that new programmer to get the confidence necessary to become successful. The 
programmer will also be able to see the part of the program they are maintaining working together with its other 
parts. 



Background Information: Master - Apprentice - As a new programmer, finding a master or a good mentor is 
important in your programming education. The advice and experience of a veteran programmer can greatly 
improve the learning experience. For one, a master programmer will be a good person to go to when things are 
not going so well. Maybe a day with a few rookie mistakes has you feeling a little insignificant. Maybe it feels like 
you are the only one who has ever made a mistake in their program. Especially a mistake that seemed so stupid. 
An experienced programmer will assure you that you are not the first programmer to make a simple mistake and 
certainly not the last. They will also tell you that mistakes are okay in programming but you should work hard not 
to make the same mistake twice. Making a mistake is a learning opportunity and you should always look at it in 
that light. 



THE SECRET: IT IS IN THE PROGRAMMING PROCESS 

This might be a good time to attempt to answer the question, "What is the secret to becoming a successful 
programmer?" Ask different programmers the answer to that question and you might get some different answers. 
But if you ask each the importance of following a consistent program development process, they will tell you that 
consistency is what makes a programmer successful. Most systems are developed using the System Development 
Lifecycle (SDLC) or some derivative of it like the Program Development Process (PDP). The SDLC process is general 
enough and at a high enough level so it can be used for everything from programming to installing network 
hardware. It is a process that is organized, logical and most importantly, repeatable. All of these components are 
critical if the process will be successful 

I have suggested in this eBook that programmers follow a process which is derived from SDLC. The program 
development process moves from planning to fact finding, to conceptual design, to coding, to test, to launch, and 
to program maintenance. As we moved from traditional to object orientated programming and then finally to 
event driven programming with the graphical interface, we have always returned to the program development 
process. 

It is important that we stay with this programming development process and that we are have this process in the 
back of our minds as we develop software. Even when the program is not being created from scratch as a new 
program, the program development process remains important in program maintenance. As we move through the 
program maintenance project for Cactus Books and Tapes, we will stop and reflect on the process as we make 
changes to a desktop program used by the Receiving Department to account for book shipments. 

A PROJECT WALKTHROUGH FOR CACTUS BOOKS AND TAPES 
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The Receiving Department at Cactus Books and Tapes consists of three employees. Alice has been an employee at 
the bookstore since its very beginning. Even though Alice does not have manager as part of her title, she has been 
the team leader of the Receiving Department for the last two years. Bob and Cindy work as Receiving Associates 
and all share members of the Department have the responsibility of receiving new books into store inventories. 
The receiving activity includes comparing packing slips against the contents of each package and then recording 
the books by ISBN number into the stores inventories system. The system in place has been effective and 
continues to accurately and efficiently log new inventory items into the system. With the increase in business, the 
receiving department has consulted with a storage space planner and it has been determined that they are 
running out of inventory storage space and need to better organize their work area. As part of the space planner's 
recommendations, they have suggested that the mini tower personal computers be replaced by smaller units 
fastened to the underside of the work table. Above the worktable would be a flat screen touch sensitive display. 
The keyboards currently take up too much table space. The only problem is that the existing software is text based 
and runs under the MS-DOS operating system. It is an event driven system that uses a text screen and has no 
graphical interface with controls to activate program logic. You have met with a salesperson that has a flat screen 
monitor and requires no special programming other than the ability to use graphical controls to control the 
program. 

For this assignment, you and the other programming intern have been asked to work together to make the 
necessary program changes. 



THE PROBLEM 

The problem could be defined as the existing applications inability to be controlled with a graphical user interface. 
Fortunately, the program logic is sound and all that needs to be changed it the creation of a graphical interface. 
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• Create problem statemsnt defining the Receiving Systefn Update. 
Review business and tectinical rationale. 



Fact Hnding .aictivitlas: interview users, DBA, criglnai programrrier 
and review existing sysLerr. Use data to create iogic models. 



Review existing code and create pseudo code and storyboard 
logic models. Update models tfial reflect the changes. Create 
storyboanls iiiuslrating the new graphical interface. 

Create PYTHON code from logic models and 
stDryboards. Create text rratrly and unit test all 
business rule logic 

• Perform program and system testing. Update documentation 
ard build on-line help. Work with technical writers to create 
user documentation Parallel implementation of pnagram. 
After 1 month compase new systeiTis reports to existing 
system to verify new system is working correctly. 



Figure 1: Our Plan for Updating the Receiving Progranns 
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FACT FINDING 



Since we have focused on a problem, we now need to do the research and fact finding necessary to understand 
what needs to be done to solve this problem. The first piece of information that we need to understand is what 
the existing system looks like. Since only the text interface will need to be changed, screen shots of the existing 
system will be required to understand what controls will be necessary and what information they will need a 
capture. We have set up an interview with Alice and have told her in advance that we are interested in getting 
screen shots of their existing receiving screens. Since we cannot count on Alice to understand the process of 
creating screen shots from a Microsoft Windows PC, we will visit her in the Receiving Department to look over the 
system and capture the screens. This is also a good time to meet with Bob and Cindy and begin to establish a 
rapport with them. They will be invaluable in our fact finding and it is very possible that we will need to continue to 
work with all three of the employees and the receiving department as we refine our logic and storyboards. We 
want to get to know them early and gain their trust. If we include the staff in this project, we will promote buy in 
to the solution that we create. This relationship could come in handy as we perform testing and as we implement 
the new programs when the maintenance is complete. 

We have also set up an interview with Fred who is the Cactus Books and Tapes database administrator and Fran 
who is also in the programming department. As database administrator, Fred will be of great importance in helping 
us with setting up program security and perhaps creating test tables for us to use while we test of program 
changes. We have also asked Fran to sit in on our discussion with Fred because Fran was the original programmer 
who developed the receiving system. As mentioned earlier in the eBook, as a programmer you will not work as an 
island and will need and want to include others. Input and advice from other technical staff and employees will 
only improve the solution. 



FINDINGS 

The interviews with bookstore staff went very well and both programmer and user left with a feeling that all 
understood what was needed to convert the existing application to one that was driven by graphical controls. It 
was determined with Fred that no database file maintenance changes would be necessary since the program 
updates really amounted to just the screen interface and the addition to the processing of graphical control 
events. File maintenance which performs adds, updates and deletes would remain the same. 

The interview with Fran was more revealing. Whereas the initial problem had stated that the software in place 
today was driven by a text interface using event driven processing, it in fact was a traditional program that used 
nested if statements, while loops). The Receiving system processed valid orders and exception orders. The 
definition of an exception order was described as an order that was shipped differently than what was 
documented on the original purchase order. This could be caused from back ordered items or when the quantity of 
items was less than what was initially ordered. The receiving screen would need to be able to process a valid order 
but also process an exception. This information constituted a major business rule in the receiving process. In 
addition, the receiving staff also had a print option available to them which would allow them to print the contents 
of the screen. This came in handy when there was an interruption and they had to leave the receiving area for 
short period of time. The new program should also have some provision made for printing out information on the 
selected order. 
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Whenever there is fact finding or program testing there will be an opportunity for reflection and further fine 
tuning of program requirements or program design. These changes should be coordinated with the end user in 
care should be made not to let slight program modifications to become major changes that change the scope of 
the project. 



Key Concepts: The requirements analysis will allow you to discover and isolate the organizations business rules. 



Related Subject: Scope creep! - A situation that all programmers must be aware of is called scope creep. Scope 
creep is a term used to define a scenario when an initial project with a set of defined deliverables starts to grow 
larger and larger with new requirements. This happens as users and programmers find new features to add or 
problems to solve. Adding to the requirements will add to the complexity and length of time necessary to 
complete the project. Scope creep has taken many a successful project and derailed it into being late and over 
budget. It's important that when a modification is requested that all agree it's a necessary modification and part of 
the original problem. It should be communicated to both management users and other programming staff that 
program has changed and that deadlines and costs may also change with it. Typically, any changes should be 
approved (i.e. management and user review) just as new projects are approved to make sure scope creep doesn't 
side track a good project making it a failure. 



Scope Creep - The term used to describe a programming project that has additional requirements appended to the 
original project after the project has started. Scope creep can cause a project to take too much time a go over 
budget. 



CONCEPTUAL DESIGN 

Since the solution requires a graphical user interface, we know that we will have to create both a storyboard and 
pseudo code that will explain how we will create the interface and build logic. The storyboard will probably be the 
most important logic model since the fundamental receiving logic is not changing. In fact, we will focus our logic 
changes on in making sure that events capture input and display output. Since the initial programs made extensive 
use of class files and concepts of code reuse, we will black box or ignore some of the details concerning the initial 
logic. We will also assume it is correct since the exiting program has no known problems. Fortunately, this basic 
receiving logic is not an issue and the fact that it is implemented within class files will allow us to limit its focus in 
our logic models. 



Black box: Black box is a term used to describe something which is unknown or undefined but part of a solution. In 
a program, a part of the programs requirement may yet to be coded but the function is known. A black box acts as 
a placeholder until that piece of the project can be completed. It can also be used to describe a piece of reusable 
code (like a class file) that is part of the program but of which the details are hidden or unknown to the 
programmer. 



We will need to focus on the screen design. We need to select graphical controls which are the most appropriate 
for the touch screens. An additional requirement over and above normal screen design would be the concern that 
the interface be ergonomically sound for busy workers who must now use their hands to target controls on a touch 
screen. The controls must be big enough and visible so that they can work as quickly on the screen as they worked 
with the keyboard. It is important remember that the old system was text based. The need for a pointing device 
like a mouse was not something that they had to contend with when receiving products. We have to make sure 
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that the touch sensitive screen, which is really a pointing device, doesn't impact their productivity. The receiving 
dock is a busy place in the need to quickly get product on the shelves or to customers on special order is critical. 



STORY BOARD 

Much of the maintenance required for this program revolves around the introduction of a graphical user interface. 
Therefore, the storyboard will be critical in ensuring that the user communicates to you a design that will be 
effective and efficient for receiving products to the store. 

I have created storyboards for the receiving screen and the exceptions screen. For these storyboards, I made use 
of a commercial application popular with programmers for diagramming flowcharts and building storyboards 
called Microsoft Visio. Although creating professionally detailed graphical designs is not a requirement, a realistic 
storyboard does let the user know exactly how the screen will look when it is completed. 




Receiving Main Screen 




Figure 2: Storyboard Main Receiving Screen 



EXISTING PSEUDO CODE LOGIC 

After the session with Fran the programmer of the original receiving screen, we're interested in looking at the 
actual program logic the currently exists. The original pseudo code was not available so we will have to take the 
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existing PYTHON program code and convert it into pseudo code. Once we have a model the logic for the initial 
application, we can then model the logic for our modified receiving application. 



At this point, we are not concerned with the receiving class which holds receiving data and methods. Since the 
business rules will remain the same for this new system, we can assume the class logic will still hold true. We are 
more interested In the logic which prompts receiving staff for order numbers and then allows the processing of 
received merchandise into the inventories system. This entire source code listing of the original system Is available 
later the chapter but what I have documented here is the pseudo code of the main logic. 



Business Rule: A business rule represents a process used by the business to make decisions (i.e. No merchandise 
return can be made without a sales receipt). Some business rules are common across businesses and some are 
unique to that business. 



MAIN LOGIC DOCUMENTED IN PSEUDO CODE 

The following pseudo code was extracted from the original receiving program. Many times the original pseudo 
code is not available so you may have to reverse engineer logic from the original program. You will also want to 
interview users and the programmers who have worked on the logic to get additional Information or confirmation 
that you are on the right track. 



Reverse engineer: Reverse engineering is the process of taking a program and duplicating either its look and feel, 
logic or both. The design and coding of the program would be done from scratch without the benefit of viewing 
the original programs code. The new program would contain original copy but still be a copy In regards to function. 



It Is also possible that the programmer used their pseudo code inside the program as program comments. If this Is 
the case extracting just the program comments into a new text file might be useful in identifying pseudo code. 

start 

myOrder = RecelvingLogic() 
myOrder.setOrderNumberC'O") 
print" Receiving Main Screen" 

while (myOrder.getOrderNumberO != "Q"): 
print 

myOrder.setOrderNumber (raw_input(" Enter Order Number or Q to Quit >> ")) 
display = myOrder.lookUpOrderO 

if (display not equal "Order Number not Found" and myOrder.setOrderNumber not equal "Q") : 

print "ORDER NO. | VENDOR | VEN. ID | QTY 

I AMOUNT 1" 

print display 
flag = 0 

while (flag not equal 1) 

dummyDisplay equals raw_input("Enter P to Process or E to 

process Exception or Q to Quit >> ") 

if (dummyDisplay.upperO not equal "Q") then 

if (dummyDisplay.upperO equals "P")then 
print "Order Processed" 
flag equal 1 
else if (dummyDisplay.upperO equals "E")then 
print "goto Exception Menu" 
flag equals 1 

else 
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print "invalid entry" 

else 

flag equals 1 

myOrder.setOrderNumberC'Q") 

else 

if myOrder.getOrderNumberO not equal "Q" then the 
print display 

end 

Analysis of this program confirms what Fran had told as an earlier meeting. The existing receiving program was not 
build on an event driven processing model. The code pattern used is similar to event driven programming but 
different enough that the new pseudo code will need to have logic created to accommodate event processing. The 
initial program relied heavily on decision structures (if statements) to guide the user through the receiving 
program logic. 

Program Updates Pseudo Code Logic 
start 

class MainScreen: 

recvLogic = ReceivingLogic() 

orderNumLabel as Label 
orderNumber as textbox 
calc as Button 
errorMessageLabel as Label 

vendorScrLabel as Label 

vendorLabel as Label 

vendorlDScrLabel as Label 

vendorlDLabel sa Label 

locationScrLabel as Label 

locationLabel as Label 

openOrdersLabel as Label 

openOrdersDataLabel as Label 

Process as Button 
Except as Button 
PrintOrder as Button 
Exit as Button 

lookUpOrder(event) 

orderNum = orderNumber. get() 
recvLogic.setOrderNumber(orderNum) 
returnedOrder.set( recvLogic. lookUpOrderO ) 

callProcessOrder{event) 

MessageBox ("Window Message", "Order Processed!") 

returnedOrder.set("") 

orderNumber.focus_set() 

orderNumber.delete(0,99) 

callExcept(event) 

tkMessageBox.showinfo("Window Message", "Display Exception Screen") 
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def callPrintOrder(self, event) 

MessageBox ("Window Message", recvLogic.lookUpOrderO) 



callExit(event) 

MessageBox ("Window Message", "Exit Program") 

end 



ANALYSIS OF RECEIVING CLASS 



One of the common elements in both the existing program and in the new graphical receiving program is the 
receiving class file. This receiving class file includes all of the data and methods necessary to enforce the business 
rules and data receiving requirements at Cactus Books and Tapes. Even though this class file remains unchanged in 
the new version of the program, it is still important for us to understand how its logic and how it will be used in 
conjunction with the graphical interface. Below are exhibits of the PYTHON programming code and the pseudo- 
code associated with the receiving class. 

Related Subject: What about Proto-typing? - One option that we have with this project is to utilize the expertise of 
the receiving a staff and prototype the application with them. This would mean the receiving staff would have 
taken more active role in the development of the application. If the application was a new one that represented a 
radical departure from the way they did this in the past this option might be a good one. But with prototype, the 
costs are always higher. Receiving staff is paid to do a job and receiving and the more time we take them away 
from the receiving dock the less work gets done. We also run the risk of over designing this application. It is 
possible to over analyze logic and since we know that the receiving process is not changing, spending time 
reengineering the process would ultimately lead to scope creep. Given this extra effort and the fact that the 
application is being modeled from an existing program, we have decided if forgo the expense or proto typing and 
stick with a more traditional approach of including the users in the requirements and certainly welcome their help 
during the testing process. Hopefully when all is said and done, we will have a good program design. 



PSEUDO CODE OF RECEIVING CLASS 

As with the main code example documented earlier, the receiving class pseudo code was created by analyzing 
PYTHON programming statements. Our pseudo code will follow a standard class design that has instance variables 
defined first and methods an event code defined next. 

start 

class ReceivingLogicO 

ReceivingLogicO 

qty equals 0 

cost equals 0 

orderNumber equals "0" 

Vendor equals "" 

VendorlD equals "" 

orderNumber equals 0 
setQty(sinVar) 

if (inVar less then 0 ) then 
qty equals inVar 

else 

print "Invalid Quantity" 
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getQ1y( ) 

return qty 



setCost(inVar) 

if (inVar less than 0 )then 
cost equals inVar 

else 

print "Invalid Cost" 

getCostO 

return cost 



setOrderNumber(inVar) 

if(inVar not equal "") then 

orderNumber equals inVar 

else 

print "Invalid Order Number" 



getOrderNumberO 

return orderNumber 



setVendor(inVar) 

if (inVar not equal "" ) then 

vendor equals inVar 

else 

print "Invalid Vendor Name" 



getVendorO 

return vendor 



setVendorlD(inVar) 

if (inVar not equal "" ) then 

vendorlD equals inVar 

else 

print "Invalid VendorlD" 



getVendorlDQ 

return vendorlD 



lookUpOrderQ 

searchVar equals 0 
cnt equals 0 

foundValue equals "Order Number not Found" 



for searchVar in self.ordersArray[] 

if searchVar[0].upper() == self.orderNumber.upper() : 
foundValue = str(searchVar[0] ) + " | " + 
str(searchVar[l]) + " | " + str(searchVar[2] )+ " | " 

tr(searchVar[3] )+" | " + str(searchVar[4] ) 
cnt equals cnt plus 1 
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return foundValue 

end 

Most languages have a function that supports the conversion of text form lower case to upper case. Pseudo code 
does not have an established standard for a function like upper so it is acceptable to insert into pseudo code 
program statements as long as the reader will be able to understand the statement. 



Background Information - Pseudo Code Revisited - There will always be a hesitation to develop pseudo code or 
flowcharts before coding. After you have programmed for a period of time, you will get the urge to as we all do to 
get busy developing the application. As you become a more experienced programmer this may on occasion work 
out just fine. Many of the newer programming languages, in their sophisticated IDE's, would allow you to shortcut 
on some of the logic and storyboarding. However, you should resist the temptation since as the program logic 
becomes more complicated it will become too difficult to code on the fly. Even a hand sketched flowchart with the 
assistance of notes taken in the form of pseudo code will greatly improve the possibilities of you understanding the 
problem in creating a program that actually solves it. 



Whenever you shortcut the programming development process your increase the chances of something going 
wrong. Let me put it another way. Let's say you have decided to paint your kitchen. The appropriate planning 
would suggest that you remove everything from the shelves and put drop cloths down so of the paint spills it will 
not spill on any of the items in the kitchen. But it is the weekend and you have other things to do. If you have 
painted before this isn't something which is complicated and it's certainly something that you've done enough 
times to attempt by just painting and not worry about getting paint on items in the kitchen (you know that this will 
be the time when the paint DOES spill). Approaching anything without a plan and process is a random event and 
therefore the results are not predictable. Use pseudo code, even if informally, whenever putting together a 
program. 



Related Subject: I'm stuck... what do I do now? - Sooner or later you will get stuck on a program. You will have a 
program that either will not compile or have a logic error that does not seem to want to show itself. Many times 
you will assume that some part of the program is wrong because it is new. If it new it must be wrong right? Wrong, 
many times the real problem is with code that you have used before. You have just got it stuck in your head that 
the problem is one thing and you have biased yourself in considering anything else. In any event, sometimes for 
those more difficult problems, you are better off soliciting another set of eyes so to help find the problem. I have 
had several students complain about how they have been stuck on a program for 2 hours only to have me find the 
error in less than two minutes (and this has also happened to me also). If you can, have someone else take a look 
at your code. Sometimes even walking them through your program code will jar something loose and the solution 
or problem becomes apparent. A fresh set of eyes with a fresh outlook can be of great help. 



CODING 



Once the storyboard and pseudo code has been created, the coding of the program becomes relatively 
straightforward. One of the concerns that the programmer must have is that the logical design represents a 
perfect world implementation. A perfect world solution is just that, a solution for perfect world. Since the 
programming language will have limitations, you may find that what the user and the designer felt was the best 
design, might not be one that can be implemented easily with the logic the storyboard supplied. For example, 
maybe the button design is new and not one that can be found within existing set of graphical controls. A search of 
third party controls yields nothing that approaches what the designer specified as a command button. In this case 
you have no alternative but to look at other options. 

In regards to programs pseudo code, different programming languages have advantages over other programming 
languages in regards to certain programming patterns. For example, one language may provide a both pre and 
post test repetition processing whereas another programming language may only provide pre test repetition 
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processing. A logic design that can't be implemented in the programming language must have changes made. The 
programmer needs to stick to logic model specifications as closely as they can but to complete the solution may 
have to deviate from the original spec. This is part of being a programmer. 

For this project, PYTHON is the language that the original system was developed with and the solution that we will 
need to implement our graphical interface. Fortunately, we covered graphical interface programming in the 
previous chapter (remarkable coincidence isn't it?). You'll be asked to also create the PYTHON code for the 
graphical interface in this chapters case study. 

EXISTING PROGRAM 

The existing program currently makes extensive use of the ReceivingClass module. As a result, one of the first of 
statements in the program is to import receiving logic from the receiving class. Once the class file is imported it 
becomes available to be called from within the PYTHON program. 

This original version of the program took advantage of a text interface that relied on a fairly extensive set of nested 
if statements to control the logic into processing or creating exceptions to products processed at the receiving 
dock. 

Due to the importance of the interactive environment, and the current programs inability to process graphical 
controls and event driven design, if statements had to be used to determine the execution of program logic based 
on keystrokes. 

As a new programmer, the existing program may not be completely understood without executing the program 
and testing the interface. As you get more experience, you'll be able to look at program language code in visualize 
the logic as it executes on the computer. Until then, it would be wise to copy this program and execute with the 
debugger or trace through the statements, to better understand how it works. For this eBook, this PYTHON 
example along with the others covered in the eBook are available with a companion CD. Load this PYTHON 
program and execute it so that you can better understand what the original program looked like. 

NEW PROGRAM 

I have broken the complete program up into sections and inserted a number of bullets within the new program 
code to describe the new logic. The source code has line numbers to tie the program statements together even 
when I have inserted text to help explain that section of the program. I also have included a screen shot of the final 
graphical interface to help visualize what the user is going to see when they run this program. 



346 
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Figure 3: Solution Screen Shot 

The original program specifications required that this new receiving system include a graphical interface for the 
receiving staff. In addition, through the analysis of the logic it has been determined that the ReceivingClass, which 
represents receiving process business rules, could be reused from the existing receiving applications. 



Related Subject: Using published code 

Many times in this textbook I've spoken of using code that is already been developed in other programs. In the 
case of PYTHON, the PTYHON web site (www.python.org) contains references and links to a variety of resources on 
the Internet where it just such reusable modules exist. The tkMessageBox dialog box module is just such a case. I 
could have created an output dialog box using the graphical controls that exist within Tkinter. But an output dialog 
box, because it is so widely used, has already been created by a program author and made available for everyone 
to use. If you browse the PYTHON web site or use a search engine to locate on PYTHON modules you'll find a 
wealth of graphical controls or functions that have already been created and can be used freely as part of your 
solution. This is also true with other programming languages. One search can yield many valuable resources. Just 
make sure that the source code is freely distributed and not copyrighted. With programming being such a labor 
intensive activity," not reinventing the wheel" are truly words to live by. 

This next section of the program is by far and away the most lengthy and time consuming to prepare. The main 
screen class contains all of the graphical controls along with any defined events. If you are developing this screen 
class with a simple text editor, the programmer can expect multiple iterations in ensuring that this screen will take 
the same appearance as the storyboard. Lining up controls for a visually appealing GUI is time consuming and a 
skill all into itself. 
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This design as with the designed promoted by many programming languages defines and configures graphical 
controls early within the class and in the order in which they are presented on the screen. The order of the 
presentation is controlled by the layout manager. Most graphical interfaces utilize the some form of layout 
manager. The layout manager dictates where controls are positioned in the window. The default layout manager 
for most programming languages is the flow layout manager. Flow layout will display controls in the window from 
left to right until there is no more room. If the control does not fit on one line it will drop to a second line in display 
underneath the top row of controls. 



Layout Manager: Many programming languages contain class objects called layout managers that assist the 
programmer in placing graphical controls on a window. The layout manager is designated before the controls are 
coded in the program. 
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Figure 4: Flow Layout Manager 



For this application, I have chosen to use the grid layout manager which allows me to control the surface of the 
display by designating each controls position by row and column. In previous examples, our PYTHON graphical 
interface programs typically existed on one line of controls. Since the receiving screens contain far more controls, I 
have separated the window display into rows and designated horizontal position by a column number. For 
example, my first row consists of a label box, a textbox (called an entry control in PYTHON), a command button 
and finally another label box. You'll find this column designation within the grid method available with each 
graphical control. In the example below, I am placing the orderNumLabel in the first row, first column of my 
display. Remember, the value of zero is often used as the first element of an array or collection. The grid is 
addressed with locations similar to the subscripts of a multidimensional array. Row 0, column 0 would be in the 
top left corner of the display. Look at the story board or screen shot to locate this label control. 



Programming Tip: Many languages use layout managers to specify how controls are position in a window. 

The remainder of this class file consists of a series of modules that will act as the event handlers for application 
events. For the lookUpOrder Module, the order number is acquired from the screen's entry control and passes it to 
the ReceivingClass so that the data associated with that order number can be retrieved and printed on the screen. 

The other event handlers identified in this class have yet to be completed. Once the coding for this application is 
finished, then but the existing code or new code will be called to complete the project. 

In some cases, the program coding necessary for the processing of the exception buttons might be the 
responsibility of another programmer. In this eBook example, the exception button has been assigned as an end- 
of-chapter task in the process button logic has been conveniently omitted as to not make this example more 
complex by introducing file or database operations to the program. As you can imagine, the process button would 
certainly lead to an update of a data base indicating that ordered products are now placed in inventory. 

TEST 

Testing for this project needs to done in three stages. The initial testing will occur as the program is being created. 
As the programmer adds lines of code, they will perform a unit test. A unit test is done on small blocks of code to 
ensure that that block is functioning correctly. Once the larger program is complete, more testing can be done to 
simulate what a typical user might do during normal operation (including error situations). This program test is 
very important but not the end of testing. 

In complex environments like that found at Cactus Books and Tapes, it is critical that a System Test is performed. 
With client server applications especially, system testing must be done to simulate the operation with an adequate 
load (number of users executing the program) on the system. Adequate load would mean having all three 
employees from the receiving department working on the program while others in the company were doing 
different activities on the network. This type of testing can sometimes be difficult to implement. With a small 
company like Cactus Books and Tapes, it is perhaps a lot more feasible but if we took a larger company that had 
50, 100 or thousands of employees, the testing would be more difficult to simulate. If the situation dictates, the 
company and application is small enough, and then a system test can yield very valuable information as to the 
success of the program. It is never good define problems in logic or programming late in the process but always 
better than after the program has been implemented into production. 
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Program Test: Program test involves testing all the programs associated with an application. It is not unusual for 
an application to contain many classes or programs. Program test would make sure all of the pieces of an 
application are working together correctly. 



System Test: System test would a application test that involved the operation of the program while other 
applications were also running. The goal in this test is to make sure the new application behaves well with other 
programs found on the system or network. Special emphasis is placed on system performance and availability. 



Production: Production is a term used to describe when an application has passed testing and is ready for 
everyday use by the user. 



Related Subject: Pseudo Code and Code Patterns, are they the same? - As you become a more experienced 
programmer, you might find yourself moving away from a pseudo code model. I think, if asked, most experienced 
programmers they would tell you that they do not used pseudo code unless it is required or if they are working on 
a logic problem that they have not experienced before. Most programmers learn that all programs are a series of 
similar program code patterns strung together to solve the particularities of each program. We are creatures of 
habit and will naturally learn and use code that has worked for us before. With these code patterns stored in the 
recesses of our brain, we recall these blocks of code and use them much the same as pseudo code. In reality, the 
experienced programmer will draw on his inventory of code patterns and supplement them with pseudo code 
when confronted with a new logic program. I should point out. As programmers, we usually don't remember line 
by line our code patterns but instead the programs we used them in. We open that program and find the code 
pattern as we remembered it. This way, the pattern is reused (copy and pasted) into a new program. 



TEST MATRIX 



Below, I have put together a first draft test matrix for the new receiving program. As I do more testing, I might 
decide to add more test cases to this list. As I gain experience with the user, they will help me uncover more texts 
for my test matrix. I can also use this test matrix for regression testing when I have to make future changes but still 
be sure that the program still meets all of the original logic processing criteria. 

Test Passed Failed Notes 

Lookup Button: Order number left blank should return and display "Order Not Found" Yes 
Lookup Button: Good order number should return and display the rest of record Yes 
Lookup Button: Bad order number should return and display "Order Not Found" Yes 

Process Order Button should mark order processed in Inventory File Partial * * File has not been added to logic 
processing (currently working with test data in array) but correct module called. Future system testing needed. 

Exception Button should allow order to should partial shipment Partial * * File has not been added to logic 
processing (currently working with test data in array) but correct module called. Future system testing needed. 
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Exception Button should allow order to should description change Partial * * File has not been added to logic 
processing (currently working with test data in array) but correct module called. Future system testing needed. 



Print Button should display order in output dialog box Yes 

End Program should close graphics interface and end program Yes 



Key Concept: A test matrix is a living document that changes as the program changes. Test cases will be added, 
changed and deleted as changes are made to the program. 

IMPLEMENTATION 

Once the program has been completely tested, it is ready for implementation. Implementation offers some 
options. For a direct cutover implementation, where new programs are loaded and old programs are deactivated, 
you must be sufficiently satisfied that the system test was extensive enough to feel confident the program is ready 
to run and has no significant errors. This is a "cold turkey" approach where you have committed to a 
implementation of the new programs with the idea of not returning back to the existing system. This approach is 
the most dramatic and some would say the most risky. 

If the program is especially complex or if failure would cause significant damage to the user or organization, a 
parallel implementation might be in order. When we do a parallel implementation where essentially saying that 
the new system in the old system will operate side by side for some period of time. At the end of the test period, 
outputs from both systems are compared to determine if both programs came up with the same results. If the new 
program returns the same outputs as the old program then we can feel confident that the program is now ready to 
be turned over to production . 

Direct cutover: Direct cutover is an implementation strategy where a date is chosen to load the new programs and 
discontinue use of the existing software. This approach is the most severe and requires extensive pre-test since 
once the new software is loaded there is typically no turning back. This approach, if successful, is the least 
expensive method of implementation. 



Parallel cutover: A parallel cutover implies that the new and existing systems will operate in tandem for some 
period of time. At the end of the parallel implementation, outputs from the new system are compared with the old 
system to make sure the new systems will perform designated requirements. This approach is considered a safer 
approach but more costly since it requires work to be done twice. Once each for the existing and new system. 
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Figure 5: Direct Cutover versus Parallel Implementation 

The Cactus Books and Tapes operation is small enough to easily implement a one week parallel test run. This 
particular receiving area is not high volume and that implication of effort, although it would slow the workers 
down, would not impact the timing of their job or require overtime or additional expense. The Chavez sisters 
would also feel more confident if the workers had the opportunity to try the system for a week and then give 
feedback as to whether the programs are ready to go or if additional rework is required. There is an expense to 
this type of implementation but the Chavez sisters feel that the added expense is justified if the program has been 
evaluated under typical work conditions. 

MAINTENANCE 

With the extensive use of classes and reusable modules, this program has been well structured for any additional 
maintenance that may come along. It would be naive unrealistic to believe that this program will not have to be 
rave visited and changes made to it. As the business changes so will business logic and therefore the logic in the 
programs that have been created. By creating a reusable class file module, we are reusing programs that reflect 
the receiving process business rules. If a receiving business rule changes (i.e. maybe the next generation of 
receiving software will accommodate bar code readers), then the change need only be made in one file (the 
receiving class file). 
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We have also developed the program with ample program code comments. These comments should help the next 
programmer understand the more complicated and difficult pieces of logic that accompany this program. We 
followed PYTHON coding conventions and used naming standards that were consistent and familiar to other 
PYTHON programmers. This too will also make maintenance of these programs much more efficient and effective. 

Programming Tip: Reusable class modules can improve the maintainability of programs by using one class in many 
programs. Changes need one be made to one class as all implementations of that class share the same logic. 

Status Cliecl< 

Can you identify the program development phases of the Cactus Books and Tapes maintenance project? 

Why was the storyboard so important to this project? 

What would be your recommendations be for an implementation strategy? 

INTERNET/INTRANET VERSUS TRADITIONAL PROGRAMS 

Perhaps the most significant difference between programming on the Internet versus programming on a 
standalone computer is the environment. An application written to run over the Internet needs to be designed as a 
client server application. Since the client and server both share in the processing, program logic written for 
Internet applications need to be synchronized between client and server to operate correctly. In other words, part 
of the program will be in the client and part of the program will be on the server. 

Synchronization is important first from a division of logic perspective. The client program needs to be run from the 
browser. Application code is delivered to the browser imbedded within the web page sent from the web server. 
This client application takes the form of a script or applet. JavaScript is the most popular client side scripting 
language and Java is the most popular applet program. Even though both of these programming languages include 
the word Java, they are in fact very different. These client side programs provide some subset of what the entire 
Internet application will deliver. For example, a Java applet might deliver a program that is run on the client 
computer and provides the user the ability to calculate a monthly car payment. Working with this client program is 
a server side program that may take that payment calculation and send it back to the server where a server side 
program would search a new car inventory for vehicles that could be sold at the price requested. 

The server side program might be written with a programming language like Visual Basic. Net or PERL. The program 
runs on the server and after the database search is complete will transmit back to the client browser a new web 
page showing the results of the requested data. In this example, the Internet application consisted of two 
programs working in concert with each other but running from separate computers. 

Related Subject: The Internet Can Be The Great Equalizer 

In my Visual Basic. Net classes, we discuss the limitations of VB programming. One of the limitations is that VB 
programs are currently only executable on Microsoft Windows Operating systems. With the .Net Framework, this 
isn't a real limitation. For example, if you have someone that has an Apple Mcintosh, they would normally be out 
of luck using your VB programs. That is unless you develop the application for the Internet. Since VB Internet 
programs run on all browsers (running on different operating systems), it is possible to parlay your experience as a 
VB programmer to create web based programs to run via a browser on a variety of operating systems (Apple, 
Linux, etc.). Pretty cool huh! 
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Internet Programming: From a Logic and Programming Perspective - From a logic perspective, you liave structures 
and objects available with Internet applications and standalone applications. You can make use of modules and 
classes to promote code reusability and pseudo code, flowcharts and UML modeling options are still viable in 
programs created for the Internet. 



Logic Tip: Internet programming has all of the same support for structures, modules and classes as with traditional 
programming. Pseudo code and flowcharts can also be used for logic modeling. 



Where you will see a difference is the coding of server side applications. Since data is traveling back in forth from 
browser to server (directed much like GUI event driven programming), as the program leaves one environment to 
another, the state of variables is lost. This means the variable loses scope and is wipe clean each time the web 
page has to go to the server for server side programming. If the program contains counters or accumulators, data 
for these variables is lost on each trip to the server. To accommodate for this behavior, session variables need to 
be used to maintain state. This means that before the program leaves the client, variables need to be saved to 
session variables and reloaded back into variables once the application returns from the server. If you get the 
opportunity to program in this environment, you will need to make sure you accommodate the stateless nature of 
variables in Internet programming. 

State: State describes the ability of variables to store a value throughout the life of the application. Internet 
applications are stateless in that variables lose their values when the web page needs to visit the server for 
processing. 



Session Variables: Special variables that are stored on the server and can be recalled and used in the client 
program after a trip to the web server. 



Programming Tip: Internet programs are said to be stateless since variable data is lost each time the Internet 
program needs to run code from the server. 



FROM A DESIGN PERSPECTIVE 

One of the nice things about traditional programming is that you usually know what hardware (particularly output 
devices) your users will have. What about the Internet. Since it is such a graphically rich environment, how can you 
count on knowing the screen size or resolution of your users. Mostly you can't. What you can do is develop to 
industry standards. In other words, the Internet programmer will know that the standard screen resolution is 800 
by 600 pixels. Some screens are less and some are more. Why do you care, especially since you know someone will 
be disappointed, because if you are at standard you will satisfy the greatest number. It is also important to know 
what other devices are included with the standard home PC. For example, most home personal computers contain 
multimedia support for sound and video. Knowing that most computers have this capability will perhaps allow you 
to consider an alternative that would otherwise be impractical if it did not exist on the average PC. 

WEB SERVICES EXPLAINED 

Another Internet based technology which has recently gained increased importance is web services. You can think 
of web services as modules or class objects deliverable over the Internet. This brings new meaning to reusability. 
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Not only is the code reusable on a single computer but it can be accessed via the Internet at a server located in 
another country. Some popular web services have been weather web services that allow programmers to connect 
to servers that will pass back weather data based on a zip code. Web services can provide support to both 
standalone applications running on a PC with Internet access or for an Internet program running from a web 
browser. The impacts of this technology (along with XML) have only just been understood and the travel, 
healthcare, government and educational sectors should benefit greatly. 



Status Check 

What is the significance of program state in an application running from an Internet server? 
What is the function of a web service? 



PUTTING IT TO USE 



The intent of this section is to introduce the new programmer to standards and techniques frequently used by 
professional programmers. Topics in this section relate to concepts introduced in the chapter but with a more 
vocational or occupational focus for students considering a career in programming. 

Why I Like Programming And Being A Programmer. 

I thought it only appropriate for this last chapter to share one programmer's perceptions on why they like 
programming and the job of programmer. That person is me. I hope my passion for programming has been 
demonstrated in this eBook. I was asked once why I liked to program so much (and why I programmed as a hobby 
after a long day of programming on the job). I came up with several reasons. I am not sure all programmers would 
agree with my reasons but I suspect they would share some. 

• I like solving problems - I am not a puzzle person. Puzzles are interesting but I really enjoy solving 
problems, real programs. Programming offers me the ability to take business problems and solve them 
with the help of the computer. I can be thoughtful, creative and a problem solver all at the same time. A 
perfect combination, I think. 

• I like the predictability of programs - With so many things being uncontrollable, I like the fact that 
computer logic is predictable and consistent. I know if the programming statements are in the correct 
sequence, I will come up with the same solution every time. Likewise, there is something reassuring that if 
there is some problem with my program, I can back track and analyze and eventually come up with a 
reason for the problem. No mysteries here. 

• I like to create - I have always been a builder. I like making things from scratch. Sure, it is great buying 
stuff from the store, but sometimes building something gives you a better perspective. For example, I 
built my own golf clubs. I did save a little money but mostly I just wanted to learn how it was done. 
Computers can simulate a lot of things and you can create everything from games to business 
applications. In all cases, you have the opportunity to build and experiment. 

• A dynamic environment - 1 used to tell people if they didn't like a technology, wait a couple of months and 
it will reinvent itself. One thing about programming, there is never a dull moment and always something 
new to learn. If you like change, you will probably like programming. 
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• Lifetime learning - I liave always liked school and loved to learn about new things. Not just topics 
concerning computers but one thing that is a definite with programming is that there will also be 
something new to learn. The dynamic environment that I mentioned in the previous bullet drives the 
need for learning. Sometimes the learning is done by yourself and sometime with others. I like to learn by 
doing and with programming there is an opportunity to practice hands on learning by creating the 
program and trying different program classes and functions. 

I am just one programmer. Find another programmer and ask them why they like programming and get their 
advice on the best way to learn more about a very rewarding and challenging career option. Good Luck! 



CHAPTER REVIEW 



Chapter summary, highlights, key terms, short answer questions, quizzes and case studies to reinforce topics 
covered in this chapter. 

CHAPTER SUMMARY 

After finishing this chapter you should understand and in some cases, demonstrate the following topics: 

• Explain and implement program maintenance using the program development lifecycle. 

o Most of the programming done by the programmer is program maintenance or modifying and 
updating existing applications. 

o Businesses try to maintain existing software to preserve their investment. The development of 
new systems is an expensive process and once a set of programs has been developed and 
working successfully, there is a financial and managerial reluctance to change something that is 
working well for the organization. 

o New programmers especially benefit from doing programming maintenance. Since new 
programmers are still learning the tools of the trade, they can develop their programming skills 
by working with existing applications. The existing application acts like a template for the new 
programmer to follow. 

o Program maintenance benefits the new programmer by providing the opportunity to see another 
programmer's work. This will strengthen the new programmer's knowledge of programming, 
debugging skills, recognition of programming patterns and confidence to take on more 
complicated programming projects. 

• Differentiate between creating a new program and maintaining an existing program. 

o Programming an new program or an existing program remains the same in regards to following 
the program development process. In other words, the programmer still works with a logic 
model as input to creating program instructions. 

o Updating or maintaining an existing program may require different analysis to understand the 
original logic models and programming. This detective work is valuable in understanding 
difference approaches to solving problems with logic. 

• Explain and demonstrate the modularization of program code to promote code reusability and simplified 
program maintenance. 
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o Using class files and reusable class modules allows the programmer to reduce the cost of 
programming by reducing duplication. IVlany programming operations are common logic/code 
patterns that can be repeated in many other programs. 

o Creating common reusable modules reduces the cost of program maintenance by limiting the 
number of places that program logic will need to be updated. 

• Describe implementation alternatives for new and updated programs 

o A direct cut over implementation is used when the programmer is sufficiently satisfied that the 
system test was extensive enough to feel confident then updated program can replace the 
existing programs. This approach is more dramatic with increased risk but with lower 
implementation costs. 

o A parallel cut over implies that the new and existing systems will operate in tandem for some 
period of time. At the end of the parallel implementation, outputs from the new system are 
compared with the old system to make sure the new systems will perform designated 
requirements. This approach is safer but more costly since it requires work to be done twice. 

• Distinguish and differentiate between traditional desk top and internet application development. 

o An application written to run over the Internet is designed as a client / server application. The 
client and server both share in the processing and therefore both will have program code to 
execute. 

o The client in Internet programming is a user running an Internet browser and the server is 
another computer running as an Internet Server. The user, with their browser, sends requests to 
the Internet server who sends back a web page. 

o Because the entire Internet program exists in two locations, the program logic written for 
Internet applications need to be synchronized between client and server to operate correctly. 

o Because program control is split between the client and server, values stored in client side 
variables are lost when doing processing on the server. Client data must be stored in session 
variables to preserve client values. 

o Values stored in a client application are said to be stateless. 



CHAPTER KEY TERMS 
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